跳到主要内容

样式与设计系统

AI 生成的界面之所以容易“像模板”,通常不是因为模型不会写样式,而是因为团队没有给它明确的视觉边界。没有 token、没有主题变量、没有组件变体规则,模型就会回落到最常见的 SaaS 模板语言。

设计系统层级图

样式系统层级图

样式系统的四层职责

层级负责什么典型制品
Brand Layer品牌语气、配色方向、排版风格品牌板、视觉关键字、禁用风格
Token Layer颜色、字号、间距、圆角、阴影的语义映射tokens.json、CSS variables
Component Layer按钮、卡片、表单、导航等变体规则组件变体表、状态规范
Screen Layer页面布局、图文节奏、插图与背景氛围页面样式骨架、视觉验收截图

Tailwind、CSS Modules、UnoCSS 怎么选

方案什么时候更合适AI 协作优点风险
Tailwind CSS页面迭代快、需要统一 utility 习惯改动粒度细、状态类清楚容易堆成类名墙,视觉语言趋同
CSS Modules组件边界明确、团队偏语义化 class局部样式更容易追踪全局 token 需要额外治理
UnoCSS需要更灵活规则生成utility 与原子化能力强规则学习成本更高

对 AI 来说,最重要的不是“用哪一个”,而是是否能清楚回答这三个问题:

  • 颜色和间距从哪里来?
  • 组件变体在什么地方定义?
  • 页面能否在不猜测品牌风格的情况下安全扩展?

代码案例:先把主题变量固定下来

:root {
--surface-page: #f5efe6;
--surface-card: #fffdf9;
--surface-strong: #1b365d;
--text-primary: #17212b;
--text-inverse: #fffaf2;
--accent-primary: #d96c3f;
--accent-secondary: #4a7c59;
--radius-card: 24px;
--space-section-y: clamp(4rem, 8vw, 7rem);
--shadow-card: 0 24px 64px rgba(23, 33, 43, 0.12);
}
export const buttonVariants = {
primary: 'bg-[var(--accent-primary)] text-[var(--text-inverse)] hover:opacity-90',
secondary: 'bg-[var(--surface-strong)] text-[var(--text-inverse)] hover:bg-slate-800',
ghost: 'border border-slate-300 bg-transparent text-[var(--text-primary)]',
} as const;

这类写法能把“品牌语言”变成真实代码资产,而不是提示词里的抽象描述。

代码案例:给 AI 明确反模板化约束

visual_rules:
avoid:
- "默认紫色或蓝灰 SaaS 配色"
- "统一 8px 圆角 + 柔和阴影的模板化卡片"
- "整页都使用同一种背景层次"
enforce:
- "所有颜色必须引用语义 token 或 CSS variables"
- "标题、正文、辅助文字必须落在既定排版层级里"
- "按钮和表单只允许使用现有组件变体"

如何避免“默认 AI 味”

先写禁用项,而不是只写期望项

“像 Apple 一样简洁”这种话对模型帮助不大。更有效的写法是同时写:

  • 哪些颜色不能出现。
  • 哪些视觉套路不能复用。
  • 哪些组件变体必须沿用已有设计系统。

页面层要有自己的视觉节奏

即便采用 Tailwind,也不应该让每个页面都复制同一套 max-w-7xl rounded-3xl shadow-lg 模板。页面层至少要有:

  • 自己的区块节奏。
  • 明确的背景与留白层次。
  • 不同模块之间的视觉转场方式。

样式系统交付检查表

  • token 是否区分了基础值和语义值。
  • 组件变体是否集中定义,而不是分散在页面 JSX 里。
  • 页面是否能在不增加新色值的情况下完成扩展。
  • 设计稿上的 hover、focus、disabled 是否有对应实现。
  • AI 生成的新样式是否复用了现有变量、间距尺度和圆角体系。

样式治理板

样式治理板

这张图的重点是把“品牌感觉”从空泛描述落回可以被实现和 review 的层次。没有 Brand 层,你很难知道该避免哪些视觉套路;没有 Token 层,样式就会重新散回组件;没有 Screen / Review 层,最终页面又会重新靠人工感觉把关。

视觉输入包最小集合

当你希望图片和视频权重提高时,样式页最需要补的不是更多形容词,而是更完整的视觉输入包:

输入最好长什么样为什么重要
品牌关键词板3 到 5 个关键词 + 2 到 3 张参考图 + 明确禁用项让 AI 知道什么是“像我们”,什么是“模板味”
token 对照表基础色、语义色、字号、间距、圆角、阴影把视觉语言变成可引用资产
状态对照图hover / focus / disabled / selected / error避免交互态靠猜
页面节奏对照图Hero、内容区、CTA、Footer 的留白层次与背景切换让页面层的视觉节奏不被统一模板吞掉

如果这四类输入都清楚,AI 生成的样式会明显更接近“系统扩展”;如果它们缺席,再强的模型也只能回落到行业平均模板。

Token 命名与分层建议

层级命名方式例子作用
基础值color.blue.950space.6原始设计值供系统内部引用,不直接在页面里消费
语义值surface.hero.backgroundtext.muted指向基础值面向组件和页面消费
组件值button.primary.bgcard.feature.shadow组件变体的组合结果便于集中维护交互态和品牌化差异
页面值pricing.hero.overlay只服务单页或单专题避免为了一次性视觉强行污染全局 token

最常见的问题是团队一上来就只建基础色表,没有语义层。这样一来,AI 只能在组件里直接引用颜色值或基础 token,最终还是会让视觉语言退回到“可以跑,但不可治理”的状态。

样式评审时必须追问的问题

  1. 这个页面是不是在复用已有品牌语言,还是又回到了默认蓝白 SaaS 模板。
  2. 新增样式有没有绕过语义 token,直接在组件或页面里写死颜色和间距。
  3. 组件变体是不是还收敛在同一个定义处,还是被散落到多个页面局部 className 中。
  4. 关键断点截图里,背景层次、区块节奏和文字层级是否仍然成立。
  5. 视频或录屏里,hover/focus/selected 等动态态有没有违背设计系统原有语气。

把这些问题写成评审模板之后,样式审查就不再是“我觉得不太像”,而是可以被新人复用、被 AI 任务包复述的结构化标准。

训练任务与媒体清单

训练任务重点至少需要提交的媒体
任务 1:把一个现有页面改成语义 token 驱动学会从色值和 utility 迁移到 tokenbefore/after 截图、token 映射表
任务 2:为按钮和卡片补完整变体学会把状态与视觉差异集中定义组件状态对照图、状态录屏
任务 3:做一个“去模板化”页面改造学会用品牌板和禁用项约束 AI参考图板、断点截图、设计说明

如果你要把这一页用作培训材料,建议每次作业都要求交一张视觉对照图。图上至少包含“参考输入”“实现输出”“差异说明”三栏。这样图片就不是装饰,而是 review 的核心证据。

样式与设计系统案例地图

样式页最容易被读成“讲审美偏好”,但真正有训练价值的,是看视觉输入、token、组件变体和交付证据如何在真实任务里一起出现:

现在最像哪种任务先看哪篇案例为什么值得搭配本页
设计输入很多,但还没把视觉语言翻成 token 和页面节奏VS Code Agents 本地到后台交接案例适合观察设计输入、brief 和长执行段如何串起来,不让视觉约束只停在截图层
现有页面能跑,但风格模板化严重,需要局部去模板化Windsurf 维护到 PR 案例适合对照“最小改动也要回到 token、变体和截图证据”,而不是只换几组颜色
设计系统或共享组件风格要做中等规模重构OpenAI Codex 重构与验证案例适合看多阶段推进时,如何保留样式边界、验证截图和风险说明

读这些案例时,建议重点观察四件事:

  1. 品牌关键词、禁用项和 token 有没有进入正式任务包。
  2. 页面私有视觉处理和共享变体有没有一开始就分层。
  3. 截图、录屏和断点对照是否真的能支撑视觉 review。
  4. 改动说明里有没有说清楚哪些页面或组件会被样式变化影响。

样式页的媒体联动表

如果你准备把这页用于带练,建议不要只给学员一张图或一篇案例,而是直接给一组“视频 + 案例 + 产物”:

前端样式媒体资产板

训练主题先看哪个视频再看哪篇案例最少要补哪些媒体产物
从设计输入提炼视觉语言Claude Code + Figma 工作流VS Code Agents 本地到后台交接案例品牌关键词板、token 对照表、关键断点截图
去模板化页面改造使用 OpenAI Codex 构建精美前端界面Windsurf 维护到 PR 案例before/after 对照图、组件状态图、差异说明
共享样式或变体重构实战演示视频列表OpenAI Codex 重构与验证案例受影响页面清单、断点截图、风险说明

视频学习路径

想练什么先看什么
理解设计系统如何约束页面实现实战演示视频列表
对照更多前端视觉案例全部视频
把样式约束接回代码审查质量门禁

视觉回归清单

当样式页写到足够详细时,最好把“看什么”也一起写出来,而不是只写“做什么”:

检查项应该怎么观察
背景层次比较 Hero、内容区、CTA 和 Footer 的层次变化,确认不是整页同一种底色
排版节奏截图中标题、正文、辅助文字是否落在同一套层级,而不是每个区块自定义一套字号
组件状态对照录屏或状态图,看 hover、focus、selected、disabled 是否延续同一语气
品牌一致性对比参考图板,确认没有回落到默认紫色、蓝白卡片或过度圆润模板样式

这张清单特别适合带训时做“图表讲解 + 对照评审”。它会逼着评审者说出具体差异,而不是只说“感觉有点不像”。

视觉评审会议建议

样式相关评审最好不要只看 diff。更有效的做法是同时打开设计板、实现截图和录屏,用 10 分钟对齐“哪里一致、哪里故意不一致、哪里是技术折中”。这能显著减少前端和设计在评论区来回打补丁。

配套图片与视频