应按基础色、语义色、状态色三层抽象定义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;
}

确保每个语义变量在不同主题下都有合理映射，而不是仅靠系统自动反转——这正是设计系统落地的关键细节。