UI 视觉设计 / 系统课时
规划图标命名与版本变更
规划图标命名与版本变更
图标系统长期维护的难点通常不是新增一个图标,而是旧名称已经被大量页面引用之后如何继续演进。本篇建立稳定命名、废弃、替换和删除规则,并用可追踪的资产清单记录兼容关系,让设计稿、代码和文档能够在版本变化中逐步迁移。
学习目标
- 为图标建立稳定、可搜索且不依赖具体页面的命名规则
- 区分新增、替换、废弃和删除四类版本动作
- 用版本清单和迁移窗口降低重命名带来的破坏性影响
命名先表达语义再表达外观
图标名称首先应该回答“它表达什么”,而不是“它长什么颜色、放在哪个页面”。例如搜索图标可以命名为 search,而不是 header-magnifier-gray。前者能跨导航、弹窗和表格复用;后者一旦换位置、换主题或重新绘制就会失去意义。
| 不稳定命名 | 更稳定的命名 | 问题所在 |
|---|---|---|
home-header-search |
search |
把使用页面写进资产身份 |
arrow-blue |
arrow-right |
把主题颜色写进名称 |
new-delete-icon |
trash 或团队约定的 delete |
用临时状态描述长期资产 |
icon-24-edit |
edit |
把展示尺寸和语义混在一起 |
同一系统还要固定词形,例如动作统一使用动词,实体统一使用名词,并提前确定同义词的唯一写法。trash 和 delete 都合理,但如果两者同时存在却表示同一图标,搜索、调用和迁移都会变得困难。
把图标变更当成一个生命周期
一个公开图标通常不会从“正在使用”直接跳到“删除”。更安全的过程是先引入新名称或新图形,让旧入口进入废弃状态并指向替代项,留出迁移窗口后,再在明确的大版本或约定的破坏性发布中删除旧入口。

新增图标通常只扩展能力;替换意味着新资产承担旧资产的语义;废弃表示旧入口暂时仍可用,但不应继续产生新调用;删除才会真正让旧名称失效。把这四个动作分开记录,可以避免“设计稿已经改名,但代码包当天就找不到旧图标”的断裂。
用资产清单记录兼容关系
仅靠聊天记录或发布说明很难维护几十甚至几百个图标。可以给图标仓库增加一份机器可读清单,记录状态、引入版本以及替代关系。下面是配置片段示例,字段名称可按团队工具链调整,但同一仓库应保持结构稳定。
{
"schemaVersion": 1,
"icons": {
"search": {
"status": "active",
"introduced": "2.0.0"
},
"magnifier": {
"status": "deprecated",
"introduced": "1.0.0",
"deprecated": "2.0.0",
"replacement": "search",
"removeAfter": "3.0.0"
}
}
}这份清单的生效行为应由构建或检查工具定义:active 项可以正常被新代码引用,deprecated 项继续兼容但产生迁移提示,replacement 指向可替换名称。验证时至少检查名称唯一、替代项真实存在,以及已经删除的名称不会继续出现在导出入口中。
让版本号表达影响范围
如果图标包对外承诺遵循语义化版本,可以按“调用方是否必须修改”判断版本级别。新增图标通常可以进入次版本;保留旧入口的废弃标记也可以作为兼容性变更发布;删除旧名称、修改导出名称或改变既有属性契约,则应留到明确的破坏性版本。
单纯优化矢量节点并不一定需要大版本,但要判断它是否改变了已经承诺的视觉语义。例如把“下载”改画成“上传”虽然文件名和调用方式没变,实际含义已经改变,不能当作普通修图静默发布。图标系统的兼容性既包括 API,也包括用户最终看到的语义。
给重命名保留迁移窗口
实际重命名时,优先采用渐进迁移,而不是一次性替换所有入口。先增加新名称,再让旧名称成为别名或兼容导出,同时在文档和资产清单中标记废弃。随后扫描产品中的旧调用,把业务代码和设计稿逐步迁移到新名称,最后才在约定版本移除兼容入口。
迁移期间应避免同时修改名称、视觉含义和调用接口,否则出现问题时很难判断是哪一层变化造成的。稳定的版本策略不是永远不改图标,而是让每一次改动都能回答三个问题:旧调用还能使用多久、应该迁移到哪里,以及从哪个版本开始旧入口会真正失效。