Arco Design

Arco Design 是字节跳动推出的企业级设计系统，提供 React、Vue 组件、图标与主题资源。React 快速上手使用 @arco-design/web-react，当前文档说明组件默认支持 tree shaking，并提供 Vite、Webpack、Unplugin 与 babel-plugin-import 等工程方案；React 19 另有适配入口。

React 与 Vue 路线先选定

两套框架实现的 API 和更新节奏需要分别验证。

按需加载要与打包器匹配

具名 import 可利用 tree shaking，但样式、图标和插件是否按需仍取决于构建配置。Rspack、Vite、Webpack 等项目应选择官方对应插件或清楚的手动方案，检查开发与生产包体、CSS 顺序及动态 import，避免重复引入全量样式。

React 19 不是只改 peer dependency

当前文档提供 React 19 adapter 的导入说明。升级时应在应用入口加载适配，并回归弹层、表单、虚拟列表、ref 与事件行为。团队封装若依赖内部 DOM 或旧生命周期，也需要单独修改，不能假定适配器会修复业务层代码。

主题工具要产出可维护的包

品牌定制不应变成散落的 Less/CSS 覆盖。先定义颜色、圆角、字号、间距和状态语义，再通过 Arco 主题能力形成版本化主题包，关联设计稿与代码。暗色、紧凑模式和不同业务线共享基础 token，只在明确层级做差异。

中后台组件补齐真实状态

• Form 的异步校验和服务端错误；
• Table 的空、加载、失败、权限与批量操作；
• Upload 的进度、取消和失败重试；
• Modal/Drawer 的焦点与未保存提醒；
• 日期、数字、时区与多语言格式。

图标与组件版本保持同步

图标可独立按需引入，但设计稿、组件默认图标和业务自定义图标应使用同一规格。升级组件包时同时检查图标命名、尺寸与样式变化；不要将整个图标包打进首屏，也不要为了省代码用字符代替语义图标。

浏览器和构建基线写入项目规范

官方文档包含浏览器兼容与不同构建方式。团队应把支持范围落实到 browserslist、自动化测试和设备清单，记录 Arco、React/Vue、插件与主题包版本。每次升级用代表性表单、表格和弹层页面做行为回归。