不读代码而读 JSON
JSON 读起来像代码,但设计师不需要会写代码,只需要能读懂它的结构:大括号表示对象,方括号表示列表,冒号连接名称和值。 这套阅读方式直接对应设计系统里三类文件:设计令牌文件、API 响应和代码评审里的数据。 读懂它们后,设计师可以把抽象的"数据可能很长"变成具体的判断,比如显示名没有固定长度,组件要决定如何截断或换行;bio 为空时卡片必须容纳无简介状态。 设计令牌分两层。基础令牌(如 blue/500)存一个具体值,语义令牌(如 background/brand)不存值,而是指向基础令牌。改变基础值会影响所有引用它的语义令牌;只改语义令牌的引用,则只影响那一个决定。 读令牌 diff 时,设计师能看出一次小改动实际波及的范围是否超出预期。 2025 年底,Design Tokens Community Group 发布了首个稳定格式规范:每个令牌带 $value 和 $type,引用仍用大括号。 类型被显式写出,工具不必再猜值是颜色、尺寸还是时长。该规范要求颜色用色彩空间和原始分量描述,hex 仅作回退。同一份清晰的数据也喂给机器和 AI 工具;一个组件可以写成"它是什么、接受什么参数、怎么用"的纯数据契约,例如 disabled 只用于不可交互状态、不能代替 loading。 规范目标是让人和工具读同一份文件。 



