#ProComponents API 变更总结 (2.0 → 3.0)

#快速参考

#已移除的 API

#版本要求变更

• antd: >= 4.20.0 → >= 6.0.0
• React: >= 16.9.0 → >= 18.0.0

#包版本变更

v3 只发布 @ant-design/pro-components 单体包；npm 上的独立子包仍属于 v2，不能与 antd 6 混装。

#迁移检查清单

#Table 组件

• columnsStateMap → columnsState.value
• hideInSearch → search: false
• fixHeader → scroll: { y: 400 }
• tip → tooltip

#Card 组件

• TabPane → tabs.items
• StatisticsCardProps → StatisticCardProps

#Layout 组件

• rightContentRender → actionsRender + avatarProps
• 布局 Token 属性重命名

#ProFormField / Field 组件

• plain → 移除，改用 variant（如 variant: 'borderless' 或 variant: 'outlined'）

#兼容性

• 移除 antd@4 兼容性代码
• 更新 antd 版本到 6.0.0+

#常用迁移命令

# 搜索废弃 API
grep -r "columnsStateMap" src/
grep -r "hideInSearch" src/
grep -r "fixHeader" src/
grep -r "tip" src/
grep -r "TabPane" src/
grep -r "rightContentRender" src/
grep -r "plain" src/

# 更新依赖
npm install antd@^6.0.0
npm install @ant-design/pro-components@beta

#回滚方案

npm install @ant-design/pro-components@^2.8.10
npm install antd@^4.24.0

详细迁移指南请参考：migration-guide.md