把 #1d4ed8 起个名字只是开始。令牌真正的价值,是让颜色、间距、字号与状态在设计稿、代码与文档里指向同一个可追溯的决定。

01分层而不是平铺

常见做法是分三层:基础令牌记录原始值(blue-600、space-4),语义令牌说明用途(color-action、spacing-inline-control),组件令牌再绑定到具体部件(button-bg)。这样换主题时只改语义层映射,不必全局搜索替换;暗色模式、品牌换色与不同产品线的差异,都落在同一套结构里。

对「设计令牌」的常见误解是把它当成一次性配置。实际上它需要在设计、开发、测试、上线后巡查四个环节各出现一次,形成闭环;只在其中一环发力,问题通常会在下一环以别的形式回来。

02命名要表达意图

按用途命名而非按外观命名:color-text-muted 比 gray-500 更能告诉使用者该在哪用;把「禁用态前景」「错误边框」「聚焦环」各自建令牌,能避免各处凭感觉挑一个相近的灰色。每个令牌应附带使用约束与对比度验证结果,尤其要覆盖 hover、focus、selected、disabled 这些状态组合。

对「设计令牌」的常见误解是把它当成一次性配置。实际上它需要在设计、开发、测试、上线后巡查四个环节各出现一次,形成闭环;只在其中一环发力,问题通常会在下一环以别的形式回来。

03治理与交付

令牌需要有唯一来源(设计文件或一份版本化的 JSON),通过构建生成各平台产物,并在 CI 里校验命名规范、对比度与是否出现硬编码色值。变更要有简短说明与影响范围,避免「顺手改一个变量」导致全站状态色漂移。对使用 AI 生成界面的团队,把可用令牌清单写进提示词,是约束产出一致性最有效的手段之一。

对「设计令牌」的常见误解是把它当成一次性配置。实际上它需要在设计、开发、测试、上线后巡查四个环节各出现一次,形成闭环;只在其中一环发力,问题通常会在下一环以别的形式回来。

要点速览

  • 基础值 → 语义用途 → 组件绑定,三层结构便于换肤
  • 按用途命名,状态色单独建令牌并记录对比度
  • 唯一来源 + 构建产物 + CI 校验,杜绝硬编码
  • 把令牌清单写进 AI 提示词以约束产出一致性

设计系统不是组件库的副产品,而是一套可执行的决定。