答案:CSS颜色命名应采用语义化变量名并建立层级系统。使用primary、success等用途命名替代blue、red字面值,通过基础色盘与设计令牌分离色值与场景,支持主题切换;结合文档、CSS自定义属性和Lint规则确保团队一致性,提升可维护性与协作效率。

在前端开发中,CSS颜色命名不仅影响代码的可读性,也直接关系到项目的视觉统一和维护效率。良好的颜色命名策略能帮助团队快速理解设计意图,减少样式冲突,提升协作体验。
使用语义化颜色变量名
避免使用如 blue、red 这类字面颜色名称作为变量名,因为它们无法体现用途且难以适应主题切换。推荐使用反映用途或层级的语义化命名方式。
- primary:主色调,用于按钮、链接等关键交互元素
- secondary:辅助色,用于次要按钮或边框
- success / warning / danger:状态色,对应成功、警告、错误场景
- text-primary / text-secondary:文本层级颜色
- bg-surface / bg-card:背景色,按组件区域划分
建立颜色系统层级结构
将颜色分为基础色盘(Base Palette)与设计令牌(Design Tokens),前者是原始色值,后者是业务场景映射。
- 定义基础色盘变量,例如:
--color-blue-500: #007BFF; - 通过设计令牌关联用途:
--color-primary: var(--color-blue-500); - 支持主题扩展,比如暗色模式只需替换令牌指向的色值
保持项目风格一致性
团队协作中,统一的颜色命名规范需要配合文档和工具保障落地。
立即学习“前端免费学习笔记(深入)”;
- 在项目文档中列出所有颜色变量及其使用场景
- 使用 CSS 自定义属性(Custom Properties)集中管理,便于全局调整
- 结合构建工具或 Lint 规则,禁止直接写死 HEX 值
- 设计系统中提供色板展示页,方便前后端对照使用










