01 设计与设计系统:从参考站到 tokens
01 设计与设计系统:从参考站到 tokens
一句话结论:设计系统不是一套好看的页面,而是一组能重复做出同样决定的约束;参考站提供感觉,Figma 提供状态,tokens 才是能交给代码的那一层。

最终采用的 A 方向:左为浅色,右为暗色。
它解决什么问题
一个人做站,没有设计评审,最大的风险不是丑,是不一致。
首页一套圆角,目录一套间距,暗色模式又一套颜色;今天觉得这个蓝色好看,明天觉得那个灰色更稳。每一页单看都还行,放在一起就像三个人做的。更麻烦的是,这种不一致会一路传进代码:按钮里写死一个 #191b1d,卡片里写死一个 24px,等要换主题或改断点时,只能全局搜索。
参考站能解决一部分问题。它给了我可以测量的数值:内容多宽、卡片什么圆角、标签多大、亮暗怎么切换。但参考站是别人的产品,视觉可以借鉴,信息架构不能搬。它需要 docs 侧边栏,我不需要;它的内容宽度是给课程列表的,我的正文要更窄;它的暗色按钮是蓝色,我希望交互尽量中性。
AI 又能解决一部分问题。它可以在几分钟内生成三个看起来完整的首页。但「生成」越便宜,「收敛」越贵:三个方向各有各的好看,每个都只画了首页,真正要落地的是四个页面、两套主题、四档宽度。没有一个地方做决定,AI 只会不断产出新的「差不多」。
所以我需要一套设计系统,而不是一堆设计稿。它要能回答三个问题:
- 这个颜色用在哪里,亮暗分别是什么?
- 这个间距为什么是 24,不是 20 或 32?
- 换一个页面、换一个宽度,哪些东西必须保持不变?
我怎么试的
我把设计阶段拆成五步:翻译参考站、让 AI 起方向、在 Figma 里补状态、读 token、把 token 分成两类交给代码。每一步都留下了一个可以检查的产物。
1. 把参考站翻译成自己的数值
第一步不是画页面,而是做减法。参考站 learn.datalumina.com 的审计表在上一篇里已经列过,这里只记录最后真正进入我系统的差异:
| 维度 | 参考站 | 我的系统 | 原因 |
|---|---|---|---|
| 宽屏内容宽度 | 约 1024px | 1200px | 三列卡片需要更宽的容器 |
| 卡片圆角 | 16px(rounded-2xl) |
8px | 更克制,和 1px 边框更协调 |
| 暗色强调 | 蓝色 #2756f7 |
中性灰交互 | 内容优先,按钮不抢注意力 |
| 详情页 | docs 章节树 + On this page | 单栏正文,最大 720px | 笔记短,不需要章节导航 |
| 标签字号 | 10px 等宽大写 | 12px Geist Mono | 中文和日期在 10px 下太难读 |
这张表比审计表更重要。审计表回答「它长什么样」,这张表回答「哪些东西属于我」。参考站给的是原则,不是像素。 我可以学它的卡片网格和等宽标签,但不必学它的内容宽度、圆角和蓝色强调。
2. 让 AI 起三个方向,用「能不能长大」来选
我用 AI 生成工具起了三个视觉方向,再在 Figma 里收敛:
| 方向 | 定位 | 覆盖范围 | 结论 |
|---|---|---|---|
| A / 安静编辑部 | 宽松留白、直接的结论、稳定三列 | 首页/目录/详情/关于 × 亮暗 × 四档 | 选用 |
| B / 工程工作台 | 紧凑信息分区、等宽索引、工程状态前置 | 仅首页 | 未选用 |
| C / 开放笔记本 | 微暖纸色、居中开场、轻盈节奏 | 仅首页 | 未选用 |

从左到右:A / 安静编辑部、B / 工程工作台、C / 开放笔记本。B 和 C 只覆盖首页,A 扩展到四个页面。
如果只看首页,B 其实更「有技术感」,C 更「有个人气质」。但我最后选了 A,理由不是它最好看,而是它是唯一扩展到四个页面的方向。
这个判断标准很关键:方向比较阶段,不要选最惊艳的,要选最能长大的。 B 的信息密度高、状态前置,放在首页很抓人,但压过 300-500 字的短笔记;它更适合作为构建日志区块的参考。C 的暖色和笔记本气质有吸引力,但结构化程度低;它的 topic chips 和轻盈节奏可以局部借用,不适合做整站骨架。
最后我从 B 保留了构建日志列表和状态标签,从 C 保留了 topic chips 和更柔和的阅读节奏。没选的方向不一定全丢,拆成零件再用。
3. 在 Figma 里把「默认态」补成「状态」
方向定下来之后,真正的工作量才开始。
第一版设计里,默认态看起来都对,但状态还不完整。实现的时候马上会遇到 hover 怎么变、选中怎么标、键盘 focus 怎么显示、暗色下这些状态还成不成立。于是我把组件扩展到 63 个组件/变体,覆盖:
- Button:Primary / Secondary,以及 Hover、Focus、PrimaryHover、Selected、SelectedHover
- Tag:Default / Selected / InProgress
- Note card:6 张示例 × Default / Hover
- Topic filter:Default / Selected / Hover / SelectedHover
- Adjacent note:Previous / Next × Default / Hover
- Build entry:Row / Stack × RAG / Blog × Default / Hover

浅色主题下的标签、按钮和笔记卡片。默认态只是起点,真正的约束在后面的交互状态。
这里面最容易被低估的是状态。一个按钮的默认态可能只要 20 分钟,hover、focus-visible、selected、selected hover 加起来要两个小时。但不补这些状态,实现阶段就会临时拍脑袋,最后每个组件的交互都不一样。

交互状态页:焦点、筛选、空状态与移动端导航。
设计评审时,我按清单逐项过,改了两轮。第一轮把亮色和暗色首页的 Hero 统一成居中布局,移除暗色独有的「NOW / 当前关注」卡片;桌面导航统一成「首页 / 笔记 / 关于」。第二轮把移动端导航也统一成「笔记」,搜索框改成「站内搜索暂未开放 / 阶段 0」的不可用占位,补齐亮色的 hover 和 selected hover,并给 Tag 增加 InProgress 变体(亮色 #245fad,暗色 #a6c5ff)。
关键色对抽样对比度是 5.58–17.27:1,满足 WCAG AA。评审结论是「通过,可进入实现」,但仍然留了五个非阻塞缺口:首页构建日志入口没画、搜索是占位、部分内容示例待替换、404 和空状态没有单独画板、Figma 文件没有变量。设计评审通过不等于设计完成,只等于可以开始实现。
4. 用 Plugin API 读 token,结果发现没有变量
设计稿要交给代码,最理想的情况是 Figma Variables 和 SCSS token 一一对应。我先查了一下文件里有没有本地变量集合:
const collections = await figma.variables.getLocalVariableCollectionsAsync()
console.log(collections)
输出是:
[]
文件里没有 Local Variable Collections。也就是说,颜色、字号、间距这些值只存在于组件实例和设计规范页里,没有一个可以直接导出的变量层。
这是一个真实的坑,也是一个必须做的决定:继续等变量,还是接受例外? 我选了后者。交接改成三件事:
- 用 Figma Plugin API 从组件实例读取实际值(填充色、内边距、字号、行高);
- 在设计规范页写清楚使用规则和状态说明;
- 把值整理进
docs/design-tokens.md,token 名称由项目自己定义。
代价是后续改设计时,Figma 和 token 文档要手动同步。这个代价我接受,因为阶段 0 只有四个页面,而且设计主体已经签收;如果后面设计频繁变动,就应该重新考虑变量或换一种交接方式。
5. 把 token 分成两类,而不是一套 SCSS 变量
最后一层是代码。最初我想把所有 token 都写成 SCSS 变量,直到意识到一个问题:SCSS 在编译期求值,亮暗主题切换发生在运行时。
所以 token 被拆成两类:
// 编译期常量:字号、行高、间距、圆角、断点
$space-24: 24px;
$radius-8: 8px;
$breakpoint-tablet: 768px;
$container-wide: 1200px;
// 运行时主题:颜色用 CSS 自定义属性
:root {
--color-bg: #fafaf8;
--color-fg: #191b1d;
--color-border: #d8dadd;
}
[data-theme='dark'] {
--color-bg: #111316;
--color-fg: #f2f3f5;
--color-border: #3b414a;
}
这条分界线后来写进了项目约束:字号、间距、圆角、断点用 $xxx;需要在亮暗之间切换的颜色用 --xxx。组件里不允许出现硬编码的颜色和间距。
响应式也做了同样的收口。设计覆盖 390 / 768 / 1024 / 1440 四档,但断点只设在 768 和 1024:
| 视口 | 左右边距 | 内容宽度 | 卡片列数 |
|---|---|---|---|
| 1440 | 120px | 1200px | 3 |
| 1024 | 48px | 928px | 2 |
| 768 | 32px | 704px | 2 |
| 390 | 24px | 342px | 1 |
1440 是宽屏目标,不是切换点。少一个断点,就少一组回归测试和一套边缘情况。 对一个人的项目,这比「覆盖所有设备」重要。
坑和限制
1. 最容易选错的是方向,不是细节。 我差点选了 B,因为它的首页更有工程感。但 B 只覆盖首页,A 能覆盖四页 × 两主题 × 四档。方向选错,后面所有细节都在给一个长不大的骨架做装饰。
2. AI 生成的是素材,不是决策。 三个方向都「看起来完整」,但没有一个能直接回答「为什么选它」。AI 可以帮你起稿、补变体、写文案,但取舍必须自己拍板。我的做法是:AI 只生成备选,收敛发生在 Figma 和评审清单里。
3. Figma 没有变量,交接会退化。 没有 Local Variable Collections,token 就无法和设计稿一一对应。接受例外可以,但要把代价写清楚:设计改动时,文档和代码要手动同步。例外不是问题,没写下来的例外才是。
4. 参考站的数值不能直接抄。 参考站内容宽 1024、卡片圆角 16、暗色按钮蓝;我的系统是 1200、8、中性灰。不是谁更好,而是产品不同。抄原则,别抄像素。
5. 状态才是真正的工作量。 63 个组件/变体里,大部分不是新组件,而是同一组件的 hover、selected、focus、in-progress。只画默认态,实现阶段一定会返工。
6. 颜色不要预先合成。 设计稿里很多 hover 是黑/白加透明度。实现时如果提前合成成不透明色,叠色就会失真。保留 rgba,让浏览器去叠。
7. 设计阶段的终点是「能实现」,不是「完美」。 我的评审清单八项全过,但仍然留了五个非阻塞缺口。继续打磨当然还能更好,但设计系统是为交付服务的,不是作品集里的一张图。
适合谁
如果你是一个人做产品、没有专职设计师的前端,这篇的路径应该能直接用:先用参考站建立审美坐标,再用 AI 起方向,最后用 tokens 把决定固定下来。
如果你已经在用 AI 生成设计,但每次生成都不太一样、收不住,问题通常不在工具,而在缺少一个做决定的地方。Figma 的组件和状态、docs/design-tokens.md 里的数值,就是那个地方。
如果你需要把设计交给代码,或者将来交给别人,token 文档比设计稿更耐用。设计稿会过期,约束不会。
它不太适合这几类人:已经有成熟设计系统和设计团队的,不需要重新造一套;追求强品牌视觉、插画和动效的,这套系统刻意做得很安静;只想套一个模板博客的,现成主题比自己做设计系统快得多。
下一篇写 02 内容模型:为什么用 Markdown 而不是 CMS。设计系统解决的是「长什么样」,下一篇解决「内容怎么进来」,以及为什么我宁愿用 Git 管内容,也不引入数据库。