必须用 document.documentElement.style.setProperty() 直接设置变量值，因为替换 link href 加载新 CSS 文件无法覆盖已生效的 :root 变量，Element Plus 组件只读取初始值且不监听后续变更，会导致样式闪烁、部分区域未更新或变量未定义报错。
能，但必须用 document.documentElement.style.setProperty() 直接改变量值，而不是换 CSS 文件或重载页面。
为什么不能直接替换 link 标签的 href
后台管理系统（如 vue-element-admin、若依 Vue3）通常已将主题变量注入 :root，所有组件样式都依赖这些变量。如果用 JS 切换 <link> 的 href 加载新 CSS 文件：
- 新文件里的
:root { --theme-color: ... }不会覆盖旧值——CSS 层叠规则下，先加载的:root声明仍有效 - Element Plus 等组件库的样式是预编译的，只读取初始
:root变量，不会监听后续 CSS 文件变更 - 会导致样式闪烁、部分区域未更新（比如表格边框色、图标 fill）、甚至控制台报
var(--xxx) used before defined
document.documentElement.style.setProperty() 怎么用才不出错
这是唯一可靠、零闪动、热更新生效的方式。关键在调用时机和变量名精度：
- 必须等 DOM 完全就绪后执行，推荐放在
mounted()或DOMContentLoaded回调里 - 变量名必须带双短横线前缀，大小写严格匹配，例如
--el-color-primary≠--ElColorPrimary - 不要传空字符串或
undefined，否则变量被清空，var(--x, #fff)的回退值才会生效，可能造成意外白底 - 批量设置时用循环，避免漏掉关键变量：
--el-color-primary、--el-color-primary-light-3、--el-color-bg、--el-color-text-primary等
示例（政务蓝主题）：
立即学习“前端免费学习笔记（深入）”；
document.documentElement.style.setProperty('--el-color-primary', '#165DFF');
document.documentElement.style.setProperty('--el-color-primary-light-3', '#4982FF');
document.documentElement.style.setProperty('--el-color-bg', '#F8FAFC');
document.documentElement.style.setProperty('--el-color-text-primary', '#1F2937');
切换后哪些地方容易漏掉颜色
只改主色和背景色远远不够。Element Plus 和业务组件大量使用隐式变量，常见遗漏点：
- 表单控件：输入框
border-color、focus阴影、placeholder文字色（对应--el-input-placeholder-color） - 按钮禁用态：
--el-button-disabled-bg-color、--el-button-disabled-text-color - 滚动条：
scrollbar-color和scrollbar-width需单独设，不继承 CSS 变量 - SVG 图标：
fill和stroke通常硬编码，需统一用currentColor或显式绑定var(--icon-color) - 弹窗遮罩层：
--el-overlay-color-light控制蒙层透明度，漏设会导致暗色模式下遮罩过浅
localStorage 存值和初始化的坑
用户刷新页面后主题丢失，八成出在这里：
- 不能在 Vue
created()钩子中读取localStorage并调用setProperty——此时document.documentElement可能尚未挂载 - 必须在
mounted()或onMounted()中执行，且要加防抖（避免 SSR 渲染时重复设置） - 存值时建议同时写入
data-theme属性：document.documentElement.setAttribute('data-theme', 'blue')，方便用[data-theme="blue"]做额外样式微调 - 首次访问无 localStorage 时，应 fallback 到系统偏好：
window.matchMedia('(prefers-color-scheme: dark)').matches
最简健壮初始化逻辑：
const saved = localStorage.getItem('theme-color');
if (saved) {
document.documentElement.setAttribute('data-theme', saved);
document.documentElement.style.setProperty('--el-color-primary', saved);
}
主题热更新真正的复杂点不在“怎么切”，而在于“切全”——变量命名是否收敛、第三方组件是否适配、边界状态（禁用、悬停、加载中）是否同步响应。一个没覆盖的 --el-color-success 就能让整个通知组件在暗色模式下变成不可读的灰绿色。
