应按基础色、语义色、状态色三层抽象定义CSS颜色变量，收敛设计稿色值后写入:root，组件引用语义变量实现设计与开发一致，并通过媒体查询或主题类支持深色模式。
直接在 CSS 中定义颜色变量，让开发与设计系统保持一致，关键是把设计规范里的色值转化为可维护的 CSS 自定义属性（CSS Custom Properties），并建立清晰的命名和层级结构。
按语义分层定义颜色变量
不要直接用 --primary-500: #3b82f6 这类带具体数值和数字后缀的命名。设计系统中的颜色应先抽象为用途，再映射到具体色值。比如：
-
基础色（Foundation）：代表品牌主色、辅色等不可替代的核心色，如
--color-brand-primary、--color-brand-secondary -
语义色（Semantic）：表达功能意图，如
--color-text-primary、--color-bg-surface、--color-border-divider -
状态色（State）：用于反馈场景，如
--color-status-success、--color-status-error、--color-status-warning
从设计稿提取并收敛色值
设计工具（如 Figma）中通常有明确的颜色样式（Color Styles），需与设计师对齐以下几点：
- 哪些是必须保留的“设计原子色”（如 Brand Blue、Success Green）
- 灰阶是否固定为 9 级（如 50–900），每级对应什么使用场景（文字、边框、背景）
- 深色模式下各语义色如何映射（不是简单反色，而是重新指定）
收敛后，将这些色值写入根级 :root，例如：
立即学习“前端免费学习笔记（深入）”；
:root {
--color-brand-primary: #3b82f6;
--color-text-primary: #1e293b;
--color-bg-surface: #ffffff;
--color-border-divider: #e2e8f0;
}
用 CSS 变量串联设计与组件
组件样式不再硬编码颜色，而是引用语义变量：
.button--primary {
background-color: var(--color-brand-primary);
color: var(--color-text-on-primary, #ffffff);
}
.card {
background-color: var(--color-bg-surface);
border: 1px solid var(--color-border-divider);
}
这样当设计系统更新主色或调整灰阶时，只需改 :root 中的变量值，全站自动同步，无需逐个修改组件。
支持深色模式与主题切换
利用 @media (prefers-color-scheme: dark) 或自定义主题类（如 html[data-theme="dark"]）覆盖变量：
:root {
--color-bg-surface: #ffffff;
--color-text-primary: #1e293b;
}
html[data-theme="dark"] {
--color-bg-surface: #0f172a;
--color-text-primary: #e2e8f0;
}
确保每个语义变量在不同主题下都有合理映射，而不是仅靠系统自动反转——这正是设计系统落地的关键细节。
