Ant Design

Ant Design 是面向企业级 React 应用的设计系统与组件库。官网当前将组件按通用、布局、导航、数据录入、数据展示、反馈等类别组织，并提供主题编辑、设计规范和开发文档。它尤其适合中后台、运营平台和流程复杂的业务系统，但组件齐全不等于业务模型已经设计完成。

先按业务层级选择组件

复杂表单从领域对象出发

先定义字段之间的依赖、权限、服务端校验和提交生命周期，再映射 Form.Item 与输入控件。动态列表、级联选择、文件上传和日期范围需要覆盖空值、异步错误、重复提交与草稿恢复；不要把所有规则都塞进一张超长表单。

Table 要处理数据决策而非只展示列

• 明确默认排序、筛选和分页由前端还是服务端负责；
• 区分关键列、辅助列和可折叠详情；
• 覆盖加载、空数据、错误与权限不足；
• 批量操作必须显示选择范围和不可操作原因；
• 大数据量评估虚拟滚动及固定列性能。

主题使用语义令牌管理

Ant Design 的主题能力适合从 primary、success、warning、error、background、text 等语义角色出发，通过 ConfigProvider 和算法统一调整。品牌色替换后还要检查悬停、选中、禁用、焦点和暗色模式，局部页面不应随意覆盖内部选择器。

国际化不仅是替换语言包

日期、分页、空状态等组件可通过 locale 配置，但产品还要处理时区、数字格式、文本长度、RTL 和业务术语。中英文切换时重点检查 Table 列宽、Form label、Modal 按钮与导航折行，不能只看默认示例。

全局反馈要建立优先级

Message、Notification、Modal 和 Drawer 同时使用容易造成干扰。瞬时结果用轻提示，需要用户处理的错误保留在任务区域，跨页面重要事件才使用通知；危险操作使用 Popconfirm 或确认对话框时，应清楚写明对象和不可逆后果。

升级按组件行为做回归

组件总览和 Changelog 会持续变化，项目应锁定版本并记录主题覆盖。升级时比较废弃 API、语义 DOM、样式算法、图标和浏览器支持，再回归表单校验、表格筛选、弹层焦点、日期时区与服务端渲染，不能只依赖截图相似。