8 月 17 日，antd 悄悄更到了 6.6.1。回头看 v5 这条线，最后一个版本停在 2025 年 12 月 18 日的 5.29.3，八个多月里一个补丁都没再打过。而 v6 从去年 11 月下旬发布到现在，九个月时间里发了 32 个版本，差不多一周一个。
如果你也守着一个还在跑 v5 的中后台项目，现在的问题其实已经不是"要不要升"，而是"什么时候升、怎么升才不踩坑"。这篇文章，就是来替你算这笔账的。
先看盘子有多大
antd 团队成员发布的年度数据显示，2024 年共有 437 万人访问了 ant.design 官网，2023 年这个数字是 507 万，访问量最多的国家是中国，193 万。微博
另一个关键数字是下载量：2024 年 antd 在 npm 上被下载了 7437 万次，GitHub Star 逼近 10 万，用得最多的组件是 Table、Form 和 Icon，一套典型的中后台三件套。
这两个数字放在一起说明一件事：你要升级的不是什么小众库，而是几十万个中后台项目的 UI 底座，任何一点变化都有真实的分量。
九个月，官方都干了什么
迭代节奏可以直接看版本号。32 个版本里最夸张的一段是今年 5 月 14 日，6.4.0、6.4.1、6.4.2 同一天发出来，上午出的版本，下午就追了两个修复。
新东西也在持续落地。6.6.0 带来了高性能虚拟列表 Listy，支持分组、吸顶和命令式滚动，官方已经把它作为 List 的接替者来推。Ant Design官网
6.5.0 则上线了 DESIGN.md、LLMs.txt 和 MCP Server，把设计语言直接写给 AI 工具读，意图很明确：AI 写代码的时代，组件库自己也得"可被机器理解"。
变化分三层，大多不致命
第一层是硬门槛，不满足就升不了。React 17 及以下不再支持，IE 被移除，默认改用 CSS Variables。还有一个容易踩的坑：@ant-design/icons 必须同时升到 6.0.0 以上，而 icons@6 和 antd@5 互不兼容，两个包必须一起升，只动一个就会炸。Ant Design官网
第二层是软废弃。List 被标记为废弃，由 Listy 接替；closeText、bodyStyle、maskStyle 这一大批老 API 全部标了 deprecated，官方口径会在 v7 中移除，并建议尽快迁移到替代 API。Ant Design官网
第三层是静默变化，最容易出回归 bug。v6 去掉了 Tag 的末尾默认间距，布局依赖这点空隙的会错位；Form.List 的 onFinish 不再带上全部数据；Modal、Drawer 的遮罩毛玻璃要显式写 mask: { blur: true } 才有。这些改动不报错，只是让页面"看起来和以前不太一样"。
先升的人，怎么说
先看维护强度：官方年度数据里，GitHub issue 的打开数和关闭数都在 3 万左右，基本做到开一个关一个。
得物技术去年 12 月底发过一篇升级实测，标题就叫《AntDesign6.0尝鲜：上手现代化组件开发》。微博知乎上有篇文章说得直白，结论是：做企业中后台选 antd 不亏，做 C 端产品别碰。知乎专栏这和我们讨论的定位一致：v6 的主场还是中后台。
坑也有曝出来的。有用户吐槽升级 antd 6 之后出现大面积 dom 泄漏，用户点不了界面。知乎但注意前提：那是一个被 AI 整体重写成 hook 写法的老项目，属于个例，不能当成升级的普遍结论。
更大的担忧出现在 7 月底：网传支付宝体验技术部被拆分，社区里开始有人问，之前维护的那些开源项目是否还会继续维护。知乎这种担心可以理解，antd 的核心维护者确实多出自这支团队。
不过评论区很快有人回应"antd 等开源项目还是会继续维护的"，再看发布节奏，7 月单月就发了 6.5.1 到 6.5.4 四个版本，节奏并没有掉。知乎
生态，还差半步
很多团队真正依赖的是全家桶。这边的进度是：Ant Design Pro v6.0.0 已在 5 月初发布，脚手架基于 React 19 + antd 6 构建。知乎专栏但 pro-components 3.x 至今还在 beta；Vue 移植版 ant-design-vue 停在 4.2.6，Vue 阵营里 Antdv Next 已经官宣对齐 v6，ant-design-vue 本体还在追赶；负责 AI 对话场景的 @ant-design/x 更新到了 2.9.0。
一句话：主包跑得快，全家桶慢半步。项目命脉在周边包上的，观望不丢人。
四种人，四种算法
新项目：直接上 v6。新功能、新文档、新工具都围绕 v6 做，起点不一样。
稳定运行的 v5 项目：不用慌，也别拖。官方提供了 Ant Design CLI，先跑 antd doctor 和 antd lint，把废弃 API 和版本差异扫出来，摸清欠账多少，再排升级的期。Ant Design官网
全家桶依赖型：等 pro-components 3.x 转正、等 ant-design-vue 跟进，期间锁死版本，别自己混搭升级。
还在要 IE、卡在 React 17 的团队：v6 与你无缘，先留守 v5，把环境治理提上日程，否则换什么组件库都救不了。
决定要升，按这个顺序来
官方迁移文档给的路径很明确：先用 CLI 扫一遍欠账；然后 antd 和 @ant-design/icons 一起升到 v6；接着重点回归三个地方——DOM 结构（部分组件语义结构有调整）、依赖 ant- 类名的自定义样式、表单和 Tag 的间距。老项目实在改不动，官方还留了"原子迁移"方案，用包别名把 v6 装进来让 v5、v6 共存，但官方也明说这不是首选，属于最后手段。
接下来，值得盯的三个信号
pro-components 3.x 什么时候转正，这直接决定全家桶用户的升级时点。
周更节奏能不能延续，尤其是在组织调整之后。
v7 什么时候提上日程，废弃 API 会在 v7 移除，早清理早轻松。
算完这笔账：v5 不再打补丁，方向已经定了；v6 本身足够稳，工具也齐，唯一悬着的是生态进度。新项目直接上，存量项目先扫再动，全家桶用户等信号。这波升级值不值得排进下半年，你应该有数了。
