CSS变量实现主题切换的正确方式是定义全局默认值并用data-theme属性局部覆盖所有相关变量，配合JS切换属性而非直接设style，注意兼容性、fallback及设计系统一致性。
怎么用 CSS 变量实现按钮主题色切换
靠硬编码改 background-color 或写多套 class 是错路——CSS 变量才是轻量、可维护的解法。核心是把品牌色抽成 --brand-color 这类自定义属性，再用 :root 定义默认值，配合 JS 切换作用域。
为什么不能只在 :root 里定义变量就完事
因为变量作用域是继承的，:root 定义的是全局默认，但主题切换需要“局部覆盖”。比如深色模式下，按钮要变暗，但文字颜色、边框、悬停态都得联动变化，只改一个 --brand-color 不够。
- 必须把所有受主题影响的样式（
color、border-color、box-shadow等）都绑定到变量上 - 切换时不是重写整个 CSS，而是切换
data-theme="dark"这类属性，再用[data-theme="dark"]选择器批量覆盖变量值 - 别漏掉
:focus-visible和:active的变量引用，否则键盘操作或点击反馈会断层
JS 切换主题时容易踩的坑
常见错误是直接改 document.documentElement.style.setProperty() ——这只能覆盖 :root，无法触发 [data-theme="dark"] 下的变量重定义。
- 正确做法：用
document.documentElement.setAttribute('data-theme', 'dark') - 确保 HTML 根元素初始有
data-theme="light"，否则第一次渲染会丢失变量值 - 如果用 localStorage 记住用户偏好，要在 DOM 加载完成后再读取并设置，否则闪屏（先亮后暗）
- 别在 CSS 里写
@media (prefers-color-scheme: dark)和 JS 切换逻辑混用，除非你明确控制优先级（JS 设置的data-theme应该高于媒体查询）
兼容性与性能注意点
CSS 变量 IE 全系不支持，如果你的项目还要兼容 IE，这条路走不通。现代浏览器没问题，但要注意变量 fallback 写法。
立即学习“前端免费学习笔记（深入）”；
- 声明时加 fallback：
background-color: var(--brand-color, #007bff);，避免变量未定义时样式崩塌 - 变量名别用连字符开头（如
--bg-color可以，--1-bg会解析失败） - 大量使用
var(--x)不影响渲染性能，但嵌套过深（var(--a, var(--b))）可能增加计算负担，一般两层内安全 - 按钮 hover 动画如果依赖变量，确保 transition 属性写在变量外层（比如
transition: background-color 0.2s），否则变量变更不会触发动画
最麻烦的其实是设计系统对齐：按钮的 --brand-color 和导航栏、输入框的同名变量是不是真的一致？别让开发切着切着发现“品牌蓝”在按钮里是 #2563eb，在 logo 里却是 #1d4ed8——这种不一致没法靠 CSS 变量自动修复。
