UI 视觉设计 / 系统课时
处理组件弃用和多产品迁移
处理组件弃用和多产品迁移
旧组件同时服务多个产品时,直接删除可能让未升级的页面发生交互或样式回归。本篇以提示消息组件拆分为例,给出可直接改用的弃用公告、替换映射、迁移台账、遗留例外规则和移除门禁。
学习目标
- 编写包含替代方案、停用节点与负责人的组件弃用声明。
- 按使用场景建立替换映射,并计算各产品的真实迁移进度。
- 使用验收清单与例外到期机制决定旧组件能否移除。
定义弃用范围和版本节点
以下是一个团队内部的设计系统案例,组件名仅为示例约定,并非某个框架的现成 API。旧版 LegacyAlert 同时承担常驻通知、成功浮层和表单错误三种职责;新版将其拆为 InlineNotice、Toast、FieldError。先列出所有使用点,避免只改组件名称却改变了用户看到反馈的位置和时机。
- 2026-11-02,组件库 v2.7: 标记 Deprecated,在 Figma 主组件说明、Storybook 文档和变更日志中同步替代映射;现有使用点仍能运行。
- 2027-01-15,组件库 v2.8: 禁止新页面、新功能继续引入旧组件;设计评审和代码评审均须检查新增引用,保留旧组件供存量页面迁移。
- 2027-04-15,计划发布 v3.0: 仅在旧版依赖清零、例外关闭且验收通过后移除旧组件。采用语义化版本时,破坏性移除应进入主版本升级。
可直接放在组件说明顶部的弃用提示如下:
按使用意图制作替换映射
逐页核查旧组件承担的任务,再选择新组件。下面的映射表既可交给设计师核对 Figma 实例,也可作为开发迁移和测试用例的输入。
| 旧组件实际用途 | 新组件 | 必须保留的行为 |
|---|---|---|
| 页面顶部的系统维护警告 | InlineNotice,警告态 |
持续展示,直至维护状态解除;不能定时消失 |
| 提交成功后短暂反馈 | Toast,成功态 |
展示约 3000 ms;不抢走当前键盘焦点 |
| 输入框下方的校验失败 | FieldError |
紧邻出错字段,错误文案与输入建立可访问关联 |
| 请求失败且允许重试 | InlineNotice,错误态 |
保留明确的重试操作,不把失败仅做成短暂浮层 |
替换时同时记录旧实例所在页面、触发条件、关闭条件和对应新状态。例如“提交失败”不能因为旧实现用了可自动关闭的 LegacyAlert,就机械映射为 Toast;用户需要足够时间阅读错误并重试。
让版本门禁与产品迁移同时推进
组件版本推进遵循“宣布弃用→禁止新增→移除评估”,每个产品的使用点独立经历“未开始→替换中→待验收→已完成”。被技术限制卡住的使用点标记为“阻塞”,只有登记批准人和到期日后才能转为“已批准例外”。例外仍是未迁移项,不能被当作已完成。

迁移顺序优先选择风险低、可快速验证的产品,再处理依赖旧容器或定制交互的产品。所有产品应使用同一份组件映射与验收标准,但允许分别锁定过渡版本;不能要求尚未完成迁移的产品直接升级到移除旧组件的主版本。
用台账追踪进度和遗留例外
以下是 2027-01-20 的示例快照,计数单位为旧组件使用点,不是页面数;每个使用点只能归属一个产品和一个当前状态。
| 产品 | 总使用点 | 已迁移 | 未迁移 | 其中获批例外 |
|---|---|---|---|---|
| 会员 App | 24 | 24 | 0 | 0 |
| 商家后台 | 40 | 32 | 8 | 0 |
| 运营平台 | 16 | 0 | 16 | 16 |
| 合计 | 80 | 56 | 24 | 16 |
真实迁移率为 56 ÷ 80 = 70%。运营平台的 16 处例外包含在 24 处未迁移项中,不能在统计时再加到已完成数量里。商家后台余下 8 处由产品 B 组在 2027-02-28 前替换;运营平台因旧容器不支持新版交互,由产品 C 组在 2027-03-31 前完成容器改造与复审。
台账至少保存:产品、页面与实例标识、旧用途、新组件映射、当前状态、负责人、设计稿与变更链接、截止日期。例外记录还需写清阻塞证据、临时兜底、设计与技术批准人、失效日期以及复审结论;超期必须重新审批,不能默认为永久豁免。
按可验证证据关闭迁移
每一处使用点在台账勾选完成前,都应满足以下验收项:
- ☐ 功能: 警告保持可见、成功提示约 3000 ms 后关闭、字段错误与相应输入关联、失败时能执行重试。
- ☐ 视觉: 在 320 px 和 768 px 宽度下检查长文案、换行与操作区;对照批准的组件基线执行视觉回归。
- ☐ 无障碍: 以键盘完成操作,放大文本至 200% 后没有信息丢失;状态不只依赖颜色,辅助技术能识别重要反馈。
- ☐ 追踪: 记录对应设计评审与测试证据,更新旧组件引用数;复制、别名或遗留页面中的实际依赖也计入。
- ☐ 发布: 产品负责人确认升级版本与回退方案;旧依赖数为 0、未关闭例外为 0,且回归结果通过,才批准移除旧组件。
如果计划移除日仍有 8 处待替换或 16 处例外未关闭,就继续保留兼容的 v2.8 版本并推迟 v3.0 移除。获批例外只允许延后迁移,不代表旧组件已经可以安全删除。