当团队还小,大家可以记住“主色是 #246BFE、间距常用 16”。产品一旦出现多品牌、深色模式、多端和多个开发团队,这种靠记忆维持一致性的方式会迅速失效。Token 的价值,是把设计决策从散落的数值变成可复用、可替换、可同步的语义层。
01 Token 不是“把所有数值变量化”,而是建立设计决策的共同语言
颜色 #246BFE 本身没有业务含义。把它命名为 blue-600 只解决了查找问题;当它进一步被引用为 color-action-primary,团队才知道这个值承担“主要操作”的角色。
因此成熟的 Token 往往至少有基础值和语义值两层:基础层描述客观数值,语义层描述使用目的。这样品牌蓝更换时,只改映射,不需要逐个页面寻找颜色。
02 Figma Variables 让 Token 不再只是规范文档里的表格
Figma 当前 Variables 可以保存颜色、数字、字符串等可复用值,并通过 Mode 处理 Light/Dark、桌面/移动或品牌变体;变量之间还能 Alias,也就是引用另一个变量。
这意味着设计文件可以真正使用 Token 驱动,而不是规范写着 spacing-04=16px,实际页面仍由设计师手填 16。规范和设计行为越接近,系统越容易维护。

03 基础 Token、语义 Token 和组件 Token 不要混成一层
例如 color-blue-600 属于基础值;color-text-link 属于语义;button-primary-background 则属于组件级映射。三层都可能有价值,但并不是所有团队都需要完整三层。
如果产品规模不大,基础 + 语义已经足够。过早建立几千个组件 Token,会让设计师为了选一个边框颜色先理解一套复杂命名体系。
04 Mode 适合表达“同一语义在不同环境下的值变化”
Light 模式下 surface-primary 可能是白色,Dark 模式下变成深灰;移动端 spacing-page 可能更小。Figma 也支持通过 Mode 管理这些上下文。
Mode 不是用来替代所有组件 Variant。按钮大小、图标位置等结构变化仍然更适合组件属性;Token 更擅长管理可以被系统性替换的值。
05 命名要表达用途,避免把当前视觉实现写死在名字里
“grey-100-text”很快会出现问题:以后设计改成米白背景,这个名字就和真实值冲突。语义名应该尽量稳定,例如 text-secondary、border-subtle、surface-raised。
基础色可以保留客观命名,因为它本来就描述色阶;语义层则应该围绕角色和状态命名。命名稳定比“看起来技术化”更重要。

06 设计和代码的同步不是导出一次 JSON 就结束
Token 真正困难的是治理:谁可以改?改了如何评审?代码什么时候同步?旧 Token 如何弃用?如果设计端随时改值,开发端季度同步一次,两边依然会漂移。
团队需要定义版本、变更记录和发布流程。即使使用自动化工具,也要有人判断这次变化是视觉调整、破坏性变更还是新语义。
07 不要为了“系统化”把偶发值强行塞进 Token
某个营销 Banner 只使用一次的特殊偏移,不一定值得创建 global token。如果系统里每出现一个数值都建变量,最终选择器会比手填更难用。
判断标准可以是:是否会跨页面、跨组件复用?是否需要主题切换?是否代表稳定设计决策?如果答案都是否,局部值完全可以保留。

08 Token 的价值最终体现在修改成本,而不是变量数量
真正成熟的 Token 体系应该让品牌换色、Dark Mode、密度模式、多端间距调整变得更可控,也让设计与开发讨论同一个名字。
如果团队有 3000 个 Token,却每次改版仍然需要逐页人工修补,那说明系统只是把数值换了个存放位置,并没有真正建立可维护的依赖关系。
09 从“值变了”到“语义变了”,变更类型要区分
把 primary-color 从蓝色调整为稍深的蓝色,通常是值层变化;把 danger 色从红色改成橙色,可能已经改变语义识别;把 spacing-page 从 24 改成 40,则可能影响大量布局。不同变更风险不一样。
可以给 Token 变更分级:视觉微调可以小版本发布,语义重命名和删除需要迁移说明。否则设计团队一句“改个变量就好了”,开发端可能面对几十个页面的回归测试。
10 多品牌系统更能体现 Token 的真正价值
同一套产品能力需要白标给多个客户时,组件结构不变,但品牌色、字体、圆角和部分密度不同。Token 可以把这些差异集中在主题层,而不是复制三套组件库。
但品牌差异如果已经涉及完全不同的信息架构和交互,不应该强迫 Token 解决。Token 擅长管理视觉和少量行为参数,不是所有产品差异的万能抽象。
常见问题
小团队需要做 Design Token 吗?
可以从最少的颜色、字体、间距语义开始,不需要复制大型公司的完整分层。
Figma Variables 就等于 Design Token 吗?
Variables 是实现和管理 Token 的工具之一;Token 更广义,涉及命名、语义、代码和治理。
Dark Mode 一定要使用 Mode 吗?
Mode 很适合管理同一语义在不同主题下的值,但具体实现仍取决于系统结构。
Token 名应该用颜色名还是用途名?
基础层可用颜色名,语义层优先用用途名,例如 text-primary、surface-brand。
Token 越多越专业吗?
不是。数量应由复用和维护需求驱动,过度细分会增加认知成本。