做产品 PMaker
tokens.css
/* 颜色 */
--color-primary: #2f6df6; --color-ink: #16151a; --color-mid: #5c5a66;
--color-faint: #9d9aa5; --color-line: #e8e7ec; --color-bg: #fafafb;
--color-success / warning / danger
/* 间距 */
--sp-1: 4px; --sp-2: 8px; --sp-3: 16px; --sp-4: 24px; --sp-5: 40px; --sp-6: 64px;
/* 字号 */
--fs-title: 28px; --fs-h: 16px; --fs-body: 14px; --fs-cap: 12px;
/* 圆角与阴影 */
--r-sm: 4px; --r-md: 8px; --r-lg: 12px; --shadow-1 / --shadow-2

四组变量,二十来行。一个人做产品,这就是全部的设计系统。

建一份最小设计系统

四组变量、二十来行代码,就能让整个项目的样式收敛。这是投入产出比最高的一次性动作。

你会遇到的现象
  • 想统一调整主题色,发现十几个文件里都写死了色号
  • 每个页面的圆角、阴影、灰度都不太一样
  • 让 AI 做新页面,它的配色跟前面几页对不上

说到设计系统容易想到几百页的规范文档,那是大团队协作的产物。一个人做产品需要的只有一层:把散在各处的数值收成一组有名字的变量。后面所有组件和页面都引用这些名字,样式就自动一致了。

四组变量

包含什么数量建议
颜色 主题色、灰阶、语义色 主题色 1 个(可拉 3 档深浅)、灰阶 6 档、语义色 3 个
间距 4 的倍数序列 6 个:4 / 8 / 16 / 24 / 40 / 64
字号 字号加配套行高 4 个:大标题 / 小标题 / 正文 / 辅助
圆角与阴影 圆角档位、阴影层级 圆角 3 档、阴影 2 档。多了会显得杂
圆角和阴影最容易被忽略,但它们是「像不像一个产品」的重要来源。同一个界面里出现 4px、6px、8px、12px 四种圆角,人一眼说不出问题,但会觉得不精致。

写在一个文件里,用 CSS 变量或者对应框架的令牌机制。关键不在用什么技术,在于后续所有地方都引用变量名,不再出现具体数值

什么时候该长大

给 AI 的话

CLAUDE.md · 设计令牌
## 设计令牌

全部样式变量定义在 src/styles/tokens.css,共四组:
颜色、间距、字号、圆角与阴影。

强制要求:
- 任何组件和页面里都不允许出现具体的颜色值、
  间距数值、字号、圆角值。一律引用变量。
- 需要一个令牌里没有的值时,先说明用途和建议值,
  等我确认后加进 tokens.css,不要就地写死。
- 新增令牌时保持命名风格一致,并说明它跟已有令牌的关系。

生成任何界面代码之前,先读一遍 tokens.css。
生成之后,检查有没有硬编码的数值并报告。

最后一句能挡住大部分样式漂移。AI 写代码时很容易顺手写一个 `#3b82f6`,主动检查一遍成本很低。