用 CSS 自定义属性如 --color-primary在 :root 下统一声明带语义前缀、单位明确配合 HTML class 切换主题避免 JS 动态注入和混用预处理器变量确保 SSR 首屏一致。怎么在多个组件里复用同一套颜色/间距/字体直接用 CSS 自定义属性--color-primary、--spacing-md定义全局变量比复制粘贴或重复写 var(--color-primary) 更可靠也比预处理器的 $primary-color 更易跨技术栈共享。所有变量必须声明在 :root 选择器下否则子组件无法继承伪类、Shadow DOM 里要额外处理变量名建议带语义前缀比如 --size-font-sm 比 --fs12 更易维护避免在变量值里写单位混用--line-height-base: 1.5 是无单位的而 --space-xs: 4px 必须带单位CSS变量和SCSS变量混用会出什么问题SCSS 变量在编译期就消失了CSS 变量是运行时生效的——两者根本不在一个阶段不能互相赋值。比如 $color: #007bff; :root { --color-primary: $color; } 这种写法在原生 CSS 中完全无效只有 SCSS 编译器能识别 $color但编译后它不会变成可运行的 CSS 变量。想共用设计系统数值把基础值抽成 JSON 或 JS 对象再分别导入 SCSS 和生成 :root 块不要用 calc(var(--space-md) * 2) 去“动态计算”变量浏览器不支持对变量做运算得提前算好再定义新变量Vue/React 组件内通过 style{{ --color-bg: theme.bg }} 动态注入时注意字符串拼接漏单位如传 24 而不是 24px为什么修改CSS变量后某些组件样式没更新常见原因是作用域覆盖或继承断裂CSS 变量依赖级联和继承父元素没声明、中间某层重写了同名变量、或用了 display: contents / replace 等破坏继承的属性都会导致下游拿不到值。用浏览器 DevTools 的 Computed 面板查 --color-text 实际解析值看它来自哪条规则而不是只看 Styles 面板里的声明Shadow DOM 内部默认不继承 :root 变量需手动在 :host 或 ::part() 上设置媒体查询里改变量如 media (prefers-color-scheme: dark) { :root { --color-text: #fff; } }必须确保该查询块被正确加载Webpack/Vite 的 CSS 提取插件有时会误删空规则如何让CSS变量适配主题切换且不闪屏关键不是“换变量”而是“换变量的源头”。把主题数据存在 document.documentElement 的 dataset 或 class 上用 CSS 类选择器驱动变量切换比 JS 批量 setProperty 更稳定、更少触发重排。 有道翻译AI助手 有道翻译提供即时免费的中文、英语、日语、韩语、法语、德语、俄语、西班牙语、葡萄牙语、越南语、印尼语、意大利语、荷兰语、泰语全文翻译、网页翻译、文档翻译、PDF翻