UI 视觉设计 / 系统课时

处理组件弃用和多产品迁移

处理组件弃用和多产品迁移

旧组件同时服务多个产品时,直接删除可能让未升级的页面发生交互或样式回归。本篇以提示消息组件拆分为例,给出可直接改用的弃用公告、替换映射、迁移台账、遗留例外规则和移除门禁。

学习目标

  • 编写包含替代方案、停用节点与负责人的组件弃用声明。
  • 按使用场景建立替换映射,并计算各产品的真实迁移进度。
  • 使用验收清单与例外到期机制决定旧组件能否移除。

定义弃用范围和版本节点

以下是一个团队内部的设计系统案例,组件名仅为示例约定,并非某个框架的现成 API。旧版 LegacyAlert 同时承担常驻通知、成功浮层和表单错误三种职责;新版将其拆为 InlineNotice、Toast、FieldError。先列出所有使用点,避免只改组件名称却改变了用户看到反馈的位置和时机。

  1. 2026-11-02,组件库 v2.7: 标记 Deprecated,在 Figma 主组件说明、Storybook 文档和变更日志中同步替代映射;现有使用点仍能运行。
  2. 2027-01-15,组件库 v2.8: 禁止新页面、新功能继续引入旧组件;设计评审和代码评审均须检查新增引用,保留旧组件供存量页面迁移。
  3. 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 移除。获批例外只允许延后迁移,不代表旧组件已经可以安全删除。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理组件弃用和多产品迁移

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通