直接改:root的CSS变量是最轻量可靠的无刷新换肤方式，需用document.documentElement.style.setProperty()更新，变量名必须带--前缀，值需加引号，配合localStorage存取主题并提前设置html class以避免闪屏。
直接改 :root 上的 CSS 变量值，是最轻量、最可靠、也最容易调试的无刷新换肤方式。 其他方案——比如动态切换 、用 JS 拼 CSS 字符串注入 、或靠多个 class 堆叠覆盖——要么有兼容性风险，要么维护成本高，要么容易和第三方组件冲突。
怎么用 JavaScript 动态更新 :root 的自定义属性
核心就是调用 document.documentElement.style.setProperty()，把新值写进 HTML 根节点的内联 style。它会立即覆盖 :root 里同名变量的初始值，所有用 var(--primary) 的地方自动重绘。
常见错误现象：
- 写了
document.body.style.setProperty()—— 错，必须是document.documentElement（即元素） - 变量名漏了两个短横线，比如写成
primary-color而不是--primary-color - 值里带单位但没加引号，比如
setProperty('--font-size', 14px)会报错，得写成'14px'
实操建议：
- 先在 CSS 里统一定义好基础变量，例如：
:root { --primary: #007bff; --bg: #fff; --text: #333; } - 换肤时只改这几个关键变量，别试图一次性覆盖全部（比如字体、阴影、圆角等），优先级低的样式可后期渐进增强
- 如果要支持深色模式 fallback，可以配合
@media (prefers-color-scheme: dark)提前兜底，但注意：用户手动切换应优先于系统偏好
怎么保存并恢复用户上次选的主题
用 localStorage 记主题名（如 'dark' 或 'light'），比 Cookie 更简洁、无网络传输开销，且能跨 tab 同步。
关键点：
- 页面加载初期就要读取
localStorage.getItem('theme')，并在上提前加上对应 class（如class="theme-dark"），否则首次渲染会闪一下浅色再变深色 - 不要等
DOMContentLoaded之后才操作，更不要等 React/Vue mount 完——CSS 变量要在样式计算前就生效 - 写入时用
localStorage.setItem('theme', 'dark')，同时立刻调用setProperty()更新变量，两者要同步
容易踩的坑：
- 只存了主题名，但没在 JS 里维护一份当前主题状态映射表，导致切换逻辑散落各处
- 清空 localStorage 后忘记重置
document.documentElement.className，残留 class 导致样式错乱
为什么不能直接用 rgba(--primary, 0.5) 这类写法
CSS 变量本身只是字符串占位符，不参与颜色函数解析。浏览器看到 rgba(--primary, 0.5) 会直接报错或忽略，因为 --primary 不是合法的颜色值。
正确做法有两种：
- 拆 RGB 分量：定义
--primary-r、--primary-g、--primary-b，再组合rgba(var(--primary-r), var(--primary-g), var(--primary-b), 0.5) - 用
color-mix()（Chrome 111+ 支持）：color-mix(in srgb, var(--primary) 50%, transparent)，但兼容性有限，生产环境慎用
更务实的建议：
- 需要半透明场景（如按钮 hover 背景），直接定义一个新变量
--primary-bg-hover，值设为rgba(0, 123, 244, 0.1)，避免运行时计算 - SVG 图标填色若依赖主题色，记得加
fill: var(--primary)，别用内联fill="#007bff"硬编码
真正难的不是换肤动作本身，而是主题变量的语义边界——哪些该抽成变量、哪些该保留具体值、哪些组件需要额外适配（比如第三方图表库、富文本编辑器）。这些没法靠一次 setProperty 解决，得从设计系统层面收敛入口。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
