主题闪烁本质是FOUC，源于浏览器先按默认主题渲染、JS后设置data-theme导致的“无主题真空期”；应以内联脚本在<head>中立即设置data-theme，并用CSS选择器批量接管变量，而非频繁调用setProperty。
主题闪烁的本质是FOUC：CSS变量还没生效，页面就先渲染了
根本原因不是CSS变量本身有问题，而是浏览器渲染流程和JS执行时机的错位。页面加载时，document.documentElement 默认没有 data-theme 或 class="dark"，所以 :root 里的变量按浅色值计算；等JS读取 localStorage、设置属性、触发重绘，中间存在几十毫秒的“无主题真空期”——这就是你看到的那一闪。
为什么用 setProperty 动态改变量会加剧闪烁
直接调用 document.documentElement.style.setProperty('--bg', '#000') 属于运行时样式注入，它不触发CSSOM重解析，只更新内联样式层。但若变量被大量元素继承（比如全站 color: var(--text)），每次调用都会迫使浏览器对所有依赖节点重新走一遍样式计算流程，可能卡住主线程，反而拖慢主题切换完成时间，让“闪”更明显。
- 避免在
scroll、input等高频事件里直接调用setProperty - 改用一次性设置
data-theme="dark"，靠CSS选择器批量接管变量值 - 如果必须用
setProperty，确保只改局部作用域变量（如仅限某个组件容器）
内联脚本抢跑比等JS框架更可靠
React/Vue 的 useEffect 或 onMounted 都晚于HTML解析完成，此时页面已按默认主题渲染过一次。真正有效的做法是在 <head> 里放一段立即执行的内联脚本：
(function() {
const theme = localStorage.getItem('theme');
if (theme) {
document.documentElement.setAttribute('data-theme', theme);
}
})();
这段代码在CSS开始解析前就执行，确保浏览器拿到HTML时，data-theme 已就位，变量能直接参与首次样式计算。
立即学习“前端免费学习笔记（深入）”；
容易被忽略的兼容细节
即使脚本抢跑成功，仍可能因以下原因残留闪烁：
-
prefers-color-scheme: dark媒体查询未兜底：没监听系统偏好变更，用户切系统模式时主题不同步 - CSS中用了
@import引入主题文件：它会阻塞关键CSS解析，导致变量定义延迟 - 字体或图标资源未预加载：主题切换后文字/图标重绘不同步，造成局部“闪”
- 过渡动画写在
:root变量上（如transition: --bg 0.3s）：无效，CSS变量本身不支持 transition
真正卡住体验的，往往不是变量怎么定义，而是第一次渲染有没有把“主题状态”塞进HTML解析的最早一环。
