直接修改 :root 中的 CSS 变量值可实现全局换色，但前提是所有颜色使用处均已替换为 var(--brand-color)，且无 JS 硬编码、内联样式或第三方库绕过；需手动替换 background-color、color、border-color、box-shadow、outline-color、伪元素样式、SVG 的 fill/stroke、表单状态色等，同时确保变量名准确、加载顺序正确、无语法错误，并避免 IE 兼容性问题。
直接改 :root 里的变量值就能全局换色，但前提是所有用到颜色的地方都已替换成 var(--brand-color)，且没有 JS 硬编码、内联样式或第三方库绕过变量链。
哪些地方必须提前用 var() 替换
不是改了 :root 就自动生效——浏览器不会“扫描”旧样式去替换。你得手动把所有显式颜色值替掉：
-
background-color、color、border-color、box-shadow、outline-color这些属性里写死的#007bff或blue都得换 -
::before和::after伪元素里的background和color容易漏，尤其图标类装饰 -
svg标签内的fill、stroke必须显式写成fill: var(--brand-color)，否则不受影响 - 表单控件如
input:focus、select:disabled、button:active的状态色常被忽略 - 第三方 UI 库（如 Ant Design、Element Plus）若未开启 CSS 变量支持，它们内部 class 不会响应你的
--brand-color
:root 覆盖必须满足的加载顺序和语法条件
Bootstrap、Tailwind 等框架编译后的 CSS 文件里，:root 已经声明了默认变量。你自定义的覆盖必须「后加载、拼写准、无语法错」：
- 你的
:root块必须放在框架 CSS 文件之后，比如在中排在bootstrap.min.css下方 - 变量名必须完全匹配：Bootstrap 5.3 是
--bs-primary，不是--primary或--bs-color-primary - 不能加
!important：--bs-primary: red !important整行会被浏览器忽略 - 冒号后要空格，结尾要分号，拼写大小写敏感（
--Brand-Color无效，--brand-color才合法） - 确保没有其他同名变量在更高优先级选择器中意外覆盖，比如
.theme-dark :root会压过普通:root
切换时 JS 操作的两个致命错误
很多人以为 document.documentElement.style.setProperty('--brand-color', '#e63946') 就完事了，结果页面没反应。问题出在作用域和触发机制：
立即学习“前端免费学习笔记（深入）”；
- 用
style.setProperty()只能改style属性上的变量，无法触发动态主题切换所需的[data-theme="dark"] :root重定义逻辑 - 正确做法是设置属性：
document.documentElement.setAttribute('data-theme', 'dark')，让 CSS 选择器自己接管变量重赋值 - 如果用了
localStorage记住偏好，务必等 DOM 加载完成再读取并设置，否则首屏渲染会先按默认主题闪一下再切 - 别把
@media (prefers-color-scheme: dark)和 JS 切换混用，除非你明确写了优先级规则（例如 JS 设置的data-theme应该高于媒体查询）
fallback 和 IE 兼容性最容易被忽略
var(--brand-color, #007bff) 的 fallback 不是万能兜底：
- 它只在变量「未定义」或「为空字符串」时生效；如果变量被设成了
invalid或unset，fallback 不触发 - IE 全系不支持 CSS 变量，
var()会静默失效，回退到初始值（比如color变成inherit），而不是用 fallback - 如果你的项目还要兼容 IE，这条路走不通，得退回 class 切换方案，比如
.theme-brand-a .btn和.theme-brand-b .btn分别写死颜色 - 变量名别用数字开头（
--1-color解析失败），也别嵌套太深（var(--a, var(--b, black))两层以内安全）
最麻烦的其实不是技术实现，而是设计系统对齐：按钮的 --brand-color、导航栏的 --brand-color、SVG 图标的 --brand-color，是不是真指向同一个色值？变量只是管道，管子里流什么水，得靠人统一灌进去。
