真正可维护的颜色系统需用css自定义属性组织,通过:root定义语义化变量(如--text-primary、--bg-surface),禁止硬编码颜色值,深色模式须整套重置变量,透明度优先用8位十六进制或hsla。

background-color 和 color 不是颜色系统,只是两个 CSS 属性。真正可维护的颜色系统,得靠 CSS 自定义属性(即 CSS 变量)来组织。
用 :root 定义统一色板
把所有主色、辅色、中性色集中声明在 :root 里,后续所有组件都复用这些变量,而不是散落各处写 #3498db 或 rgb(52, 152, 219)。
常见错误是只定义几个“主题色”,却漏掉语义化层级:比如 --text-primary、--text-secondary、--border-divider、--bg-surface 这类用途明确的变量,比 --blue-500 更易维护。
示例:
/* 推荐:按用途命名 */
:root {
--text-primary: #2c3e50;
--text-secondary: #7f8c8d;
--bg-surface: #ffffff;
--bg-overlay: rgba(0, 0, 0, 0.04);
--border-divider: #e0e0e0;
--brand-primary: #3498db;
--brand-success: #2ecc71;
--brand-warning: #f39c12;
}
避免硬编码十六进制值在组件内部
一旦在某个 .button 的样式里直接写 background-color: #3498db;,就等于绕过了整个颜色系统——改主题时你得满项目搜 #3498db,还容易漏掉。
应该始终通过变量引用:
.button {
background-color: var(--brand-primary);
color: var(--text-on-primary, white); /* 提前约定 fallback */
}
注意两点:
-
var()支持第二个参数作为降级值,比如var(--text-on-primary, white),防止变量未定义时样式崩坏 - 别省略单位或括号——
var(--spacing-md)是合法的,但var --spacing-md会报错
支持深色模式时,@media (prefers-color-scheme: dark) 必须重置全部变量
很多人只改了 --bg-surface,结果 --text-primary 在深色背景下还是深灰,文字几乎看不见。
正确做法是整套变量覆盖,而非局部修补:
@media (prefers-color-scheme: dark) {
:root {
--text-primary: #ecf0f1;
--text-secondary: #bdc3c7;
--bg-surface: #2c3e50;
--bg-overlay: rgba(255, 255, 255, 0.06);
--border-divider: #34495e;
}
}
关键点:
- 深色模式不是“换个背景就行”,它是一套独立的色彩映射关系
- 别用
filter: invert()或mix-blend-mode搞“自动反转”,它们破坏语义、干扰可访问性、且对图片/图标效果不可控
透明度别只靠 rgba() 硬写,优先用 8 位十六进制或变量组合
rgba(0, 0, 0, 0.04) 和 #0000000a 效果一样,但后者更紧凑、可被 CSS 变量直接接收;而前者无法赋值给 var(--bg-overlay),因为 rgba() 是函数,不是颜色值。
所以推荐两种写法:
- 8 位十六进制:
#0000000a(#RRGGBBAA),兼容现代浏览器(Chrome 65+、Firefox 49+、Safari 12+) - 变量叠加:
--bg-overlay: hsla(0, 0%, 0%, 0.04);,HSLA 同样是合法颜色值,能被var()直接使用
切记:不要在变量里存 rgba(…) 字符串,CSS 解析时不会执行函数调用,只会当普通文本对待。
颜色系统最难的部分不在定义,而在约束——团队是否真的只用变量、不手写颜色值;是否每次新增 UI 元素时,都先查表再选色,而不是“这个蓝看着顺眼就用了”。没有纪律的设计,再漂亮的色板也只是摆设。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











