README

Language : English | 简体中文

Ant Design Pro



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








!



- 预览：https://preview.pro.ant.design
- 使用文档：docs/cheatsheet.zh-CN.md
- 更新日志: https://github.com/ant-design/ant-design-pro/releases
- 常见问题：docs/cheatsheet.zh-CN.mdfaq
- 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 刷新。

 支持环境

现代浏览器。

| Edge | Firefox | Chrome | Safari |
| --- | --- | --- | --- |
| Edge | last 2 versions | last 2 versions | last 2 versions |

 参与贡献

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

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

Top issues

Discussions

Latest release

中文 | English



 Ant Design Pro v6.0.3

本次更新聚焦基础设施现代化、稳定性与依赖安全：迁移至 Vitest，接入 Umi 的 Tailwind CSS v4 插件，将最低 Node.js 版本提升至 22，并升级 antd、Umi、TypeScript 等核心依赖。

---

 🆕 新功能

- 测试框架从 Jest 迁移至 Vitest，并补充核心页面测试覆盖 (11841, 11847)
- 使用 @umijs/max 的 Tailwind CSS v4 插件 (11870)

 🐛 Bug 修复

- 移除请求拦截器中的硬编码演示 Token (11833)
- 修复侧边栏折叠时仍显示链接文字的问题 (11834)
- 尊重 layout.locale 配置隐藏语言切换入口 (11836)
- 修复 Windows 下 Tailwind CSS 导入失败的问题 (11879)
- 修复账户设置中的地区级联选择 (11882)
- 修复 versionItems 地址解析问题 (11905)

 💅 改进

- 最低 Node.js 版本提升至 22，并优化 CI 缓存、并行任务及 Ant Design CLI 检查 (11840, 11850, 11898)
- 升级 antd 至 6.6.0、Umi 至 4.7.3、TypeScri