建立设计 Token 体系时：定义颜色、间距、字体…

在搭建设计系统的基础 token 层时，用于定义、组织和文档化跨平台视觉常量及命名/使用规则。

适用场景

解决思路

1. 定义并组织颜色、间距、字体排版和阴影的 token，并制定命名与使用规则。
2. 定义、组织和文档化设计 token，即驱动视觉一致性的原子值。
3. 采用 token 分类法、命名层级和跨平台映射来设计 token 体系。
4. 建立颜色 token：定义全局色板、别名 token（如 `surface`、`text`、`border`）和组件 token。
5. 建立间距 token：定义基础单位（4px/8px）、从 xs 到 3xl 的尺度，以及上下文 token（`inset`、`stack`、`inline`）。
6. 建立字体排版 token：定义字体族、字号尺度、字重和行高。
7. 建立阴影 token：定义阴影层级和 z-index 尺度。
8. 建立边框 token：定义圆角尺度、描边宽度尺度和样式选项。
9. 建立动效 token：定义持续时间尺度和缓动函数。
10. 创建第 1 层全局 token：定义原始值（例如 `blue-500: #3B82F6`）。
11. 创建第 2 层别名 token：定义语义引用（例如 `color-action-primary`）。
12. 创建第 3 层组件 token：定义组件范围内的用法（例如 `button-color-primary`）。
13. 按命名模式 `{category}-{property}-{variant}-{state}` 命名 token。
14. 先从全局 token 开始，再创建语义别名。
15. 组件中绝不引用原始值。
16. 为每个 token 文档化使用上下文。
17. 将 token 与设计系统一起进行版本管理。
18. 通过保持别名 token 抽象来支持主题化。

适用边界 · 注意事项

• 需要审计现有 token 用法时，不适用；改用 `design-token-audit`（designer-toolkit）。
• 需要多品牌映射时，不适用；改用 `theming-system`。