Ant Design Pro v6.0.2：AI 帮你把老项目升到最新版

预计阅读时间：7 分钟

升级框架版本这件事，大多数开发者的体验是：改依赖、跑构建、修报错、再改依赖……循环往复，尤其跨多个大版本时，模板文件和配置结构都变了，手动合并几乎是一场灾难。Ant Design Pro v6.0.2 直接把这件事交给 AI 来做——新增 /pro-upgrade 技能，自动对比最新模板并合并框架变更，任意版本跨度都能一步到位。

核心变化：AI 辅助升级

这次更新最值得关注的不是版本号本身，而是 pro-upgrade 这个能力。它的逻辑很直接：

拿你当前项目的模板文件和最新 Ant Design Pro 模板做 diff；
识别哪些是框架层面的结构性变更（路由配置、布局文件、构建脚本等）；
自动合并这些变更，同时保留你自己的业务代码不动。

这意味着从 v4 直接跳到 v6，理论上不再需要逐版本爬楼梯。issue #11801 的讨论里明确提到了"支持任意版本跨度升级"，这对长期维护的老项目来说是实打实的减负。

antd 升级到 6.4.2 与主题色更新

底层依赖 antd 升到了 6.4.2，随之而来的是主题色切换到 antd v6 的默认配色。如果你的项目之前自定义了主题变量，升级后需要确认两件事：

原有的 token 配置是否仍然生效（antd v6 的 Design Token 体系有调整）；
业务页面中硬编码的颜色值是否和新默认色产生视觉冲突。

没有自定义主题的项目，升级后界面会直接切换到新配色，视觉变化明显，建议先在预览环境确认效果。

依赖与 CI 优化

v6.0.2 还清理了依赖树并优化了 CI 流程，同时修复了 react-doctor 的 lint 警告（#1178）。这些改动不涉及业务代码，但能让开发环境更干净、构建更稳定。如果你之前被 lint 警告干扰过，这次应该清净了。

实操：用 pro-upgrade 升级你的项目

下面是一个完整的升级流程，可以直接在你的 Ant Design Pro 项目里跑。

1. 确保项目使用最新脚手架

如果你还在用老版本的脚手架工具，先更新它：

# 更新 pro-cli 到最新版
npm update -g @ant-design/pro-cli

# 确认版本
pro-cli --version

2. 在项目中执行 AI 辅助升级

进入你的项目目录，执行升级命令：

cd your-ant-design-pro-project

# 执行 pro-upgrade，AI 会自动对比最新模板并合并变更
npx @ant-design/pro-cli upgrade

执行后你会看到类似这样的交互输出：

🔍 正在对比当前项目与最新模板差异...
  - config/routes.ts: 路由结构有更新
  - src/layouts/BasicLayout.tsx: 布局组件有更新
  - package.json: 依赖版本需升级

🤖 AI 正在合并框架变更，保留你的业务代码...
  ✔ config/routes.ts 已合并（保留自定义路由，补充新模板结构）
  ✔ src/layouts/BasicLayout.tsx 已合并
  ✔ package.json 已更新依赖

✅ 升级完成，请运行以下命令验证：
  npm install && npm run dev

3. 手动确认主题配置

如果你的 config/defaultSettings.ts 里自定义了主题色，升级后需要对照 antd v6 的 Token 体系做调整：

// config/defaultSettings.ts — 升级前可能是这样
export default {
  theme: {
    primaryColor: '#1890ff', // antd v4/v5 的默认蓝
  },
};

// 升级后建议切换到 v6 默认配色，或保留自定义但确认 Token 映射
export default {
  theme: {
    token: {
      colorPrimary: '#1677ff', // antd v6 默认主色
    },
  },
};

注意：primaryColor 在 v6 中已迁移到 token.colorPrimary，旧字段可能仍兼容但建议尽早切换。

4. 验证构建与页面

npm install
npm run dev

打开浏览器逐页检查：布局是否正常、主题色是否一致、自定义路由是否保留。如果有页面样式异常，大概率是硬编码颜色值需要同步更新。

升级前的检查清单

检查项	说明
Git 分支状态	在干净分支上操作，方便回滚
自定义主题变量	确认 `primaryColor` → `token.colorPrimary` 的迁移
硬编码颜色值	业务代码中 `#1890ff` 等旧色值需替换
路由配置	`pro-upgrade` 会合并，但自定义路由建议手动复核
CI 流程	升级后跑一遍完整 CI，确认 lint 和构建无报错

什么时候该用，什么时候先等等

适合立刻升级：项目版本停留在 v5 或更早，且团队有精力做一轮视觉验收；新项目直接用 v6.0.2 起步。
建议暂缓：项目正处于密集交付期，主题色切换可能引发设计走查；大量硬编码颜色值散落在各处，替换成本高。

pro-upgrade 解决的是框架层面的合并难题，但业务代码的适配——尤其是主题和样式——仍然需要人眼确认。把它当成一个自动化 80% 机械工作的工具，剩下 20% 的判断留给开发者自己，这才是最稳妥的升级路径。