跳到主要内容
Ed. notes

01 设计与设计系统:从参考站到 tokens

长文 · 2026-11-10 · 合集第 2 / 12 篇

  • 构建日志
  • 设计系统
  • Figma
  • Design Tokens
第 2 / 12 篇 · 查看全部章节 → 当前:01 设计与设计系统:从参考站到 tokens

01 设计与设计系统:从参考站到 tokens

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

A 方向首页在浅色与暗色主题下的对比

最终采用的 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 开放笔记本

从左到右: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。也就是说,颜色、字号、间距这些值只存在于组件实例和设计规范页里,没有一个可以直接导出的变量层。

这是一个真实的坑,也是一个必须做的决定:继续等变量,还是接受例外? 我选了后者。交接改成三件事:

  1. 用 Figma Plugin API 从组件实例读取实际值(填充色、内边距、字号、行高);
  2. 在设计规范页写清楚使用规则和状态说明;
  3. 把值整理进 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 管内容,也不引入数据库。

继续探索