README.Zh CN - Ant Design Pro

Language : English | 简体中文

<h1 align="center">Ant Design Pro</h1> <div align="center">

开箱即用的中台前端/设计解决方案。

</div>

预览：https://preview.pro.ant.design
使用文档：docs/cheatsheet.zh-CN.md
更新日志: https://github.com/ant-design/ant-design-pro/releases
常见问题：docs/cheatsheet.zh-CN.md#faq
v6 正式发布！ — 查看 v6 更新内容

特性

:bulb: TypeScript: 应用程序级 JavaScript 的语言
:scroll: 区块: 通过区块模板快速构建页面
:gem: 优雅美观：基于 Ant Design 6 体系精心设计
:triangular_ruler: 常见设计模式：提炼自中后台应用的典型页面和场景
:rocket: 最新技术栈：使用 React 19/Umi Max 4/antd 6/utoopack 等前端前沿技术开发
:iphone: 响应式：针对不同屏幕大小设计
:art: 主题：基于 Tailwind CSS v4 + antd-style 的可配置主题满足多样化品牌诉求
:globe_with_meridians: 国际化：内建业界通用的国际化方案
:gear: 最佳实践：良好的工程实践助您持续产出高质量代码
:1234: Mock 数据：实用的本地数据调试方案
:robot: AI 助手：内置 AI 聊天助手页面，基于 Ant Design X
:white_check_mark: UI 测试：自动化测试保障前端产品质量

模板

- 欢迎页
- Dashboard
  - 分析页
  - 监控页
  - 工作台
- 表单页
  - 基础表单页
  - 分步表单页
  - 高级表单页
- 列表页
  - 搜索列表（文章/项目/应用）
  - 查询表格
  - 标准列表
  - 卡片列表
- 详情页
  - 基础详情页
  - 高级详情页
- 结果
  - 成功页
  - 失败页
- 异常
  - 403 无权限
  - 404 找不到
  - 500 服务器出错
- 用户
  - 用户中心页
  - 用户设置页
- AI 助手
- 账户
  - 登录
  - 注册
  - 注册成功

使用

开始使用

克隆或下载本项目到本地：

bash

git clone --depth=1 https://github.com/ant-design/ant-design-pro.git myapp
cd myapp

安装依赖

bash

npm install

开发

bash

# 启动开发服务器（默认为完整版）
npm start

精简为简单版本

本项目默认包含所有区块。如果你需要一个最小化的版本，运行：

bash

npm run simple

这将会：

删除多余的页面目录（dashboard、form、list/*、profile、result、exception、account 等）
删除多余的 mock 文件
替换路由为简单版本
从 package.json 中移除多余的依赖

注意：此操作不可逆，将永久删除文件。

构建

bash

npm run build

更多信息请参考使用文档。

AI Skills（Claude Code）

本项目内置了两个 Claude Code Skills，位于 .claude/skills/ 目录下：

Skill	触发词	说明
`/pro-upgrade`	"升级"、"upgrade pro"、"update to latest"	自动升级到最新 Ant Design Pro 版本。对比最新模板差异，合并框架变更并保留业务代码。
`/antd`	antd 相关代码或问题	查询 antd 组件 API、props、token、demo；检查废弃用法；跨版本迁移 — 基于 `@ant-design/cli`。

在 Claude Code 中使用：

bash

# 升级项目到最新 Pro 版本
/pro-upgrade

# 查询 antd 组件信息、调试问题、运行 lint 等
/antd

💡 如果你的项目是从本仓库克隆的，这些 skill 已经内置，无需额外安装。如需获取最新 skill 定义，可以从模板拉取更新或运行 npx skills add ant-design/ant-design-pro 刷新。

支持环境

现代浏览器。

</br>Edge	</br>Firefox	</br>Chrome	</br>Safari
Edge	last 2 versions	last 2 versions	last 2 versions

参与贡献

我们非常欢迎你的贡献，你可以通过以下方式和我们一起共建 :smiley:：

在你的公司或个人项目中使用 Ant Design Pro。
通过 Issue 报告 bug 或进行咨询。
提交 Pull Request 改进 Pro 的代码。