Nuxt 3 博客夜间模式首屏闪白:我用 Cookie、内联脚本和 SSR 注水修复主题闪烁
夜间用户打开博客先被白屏闪一下,问题出在主题偏好没在服务端、Cookie 和客户端激活之间一致传递。我用 Cookie 记录偏好、内联脚本提前设类,再通过 SSR 注水让首屏不闪。

作者
ZHOUYI
前阵子有读者反馈,晚上打开博客,内容还没出来,先被一整块白色闪到。我自己夜里复现,确实像有人拿手电筒晃了一下。问题不在样式表加载慢,而是主题偏好没在服务端、Cookie 和客户端激活之间对上。
闪白的根源
最开始的实现是 mounted 后读 localStorage,再给 html 加 dark 类。SSR 输出的 HTML 只能按默认浅色渲染,浏览器先拿到浅色页面,等 JS 执行才切深色。中间这段空档,就是闪白。若偏好存在 Cookie,服务端能读到,但客户端水合时又只看 localStorage,也会出现两边不一致。
- 只存 localStorage:服务端渲染读不到
- 只靠客户端插件切换:晚于首屏绘制
- Cookie、状态、系统偏好来源不统一:水合后反复修正
我最后的修法
思路很简单:主题偏好优先落到 Cookie,服务端按 Cookie 渲染初始类名;同时在 head 里放一段内联脚本,在 Vue 激活前读 Cookie 并设置 dark 类;客户端插件只负责同步 UI 状态,不再首屏改主题。若用户选“跟随系统”,脚本会读取 prefers-color-scheme,并把最终结果写回 Cookie,避免服务端瞎猜导致水合不一致。
const theme = useCookie('theme')
useHead({
htmlAttrs: {
class: theme.value === 'dark' ? 'dark' : ''
},
script: [{
innerHTML: `const m=document.cookie.match(/theme=(dark|light)/);const d=m?m[1]==='dark':matchMedia('(prefers-color-scheme: dark)').matches;document.documentElement.classList.toggle('dark',d)`,
type: 'text/javascript'
}]
})这里有两个小坑。第一,内联脚本要足够小,别引外部文件,否则又回到等 JS 的老路。第二,切换主题时尽量只改 html 的 class 或 data-theme,CSS 变量跟着变,避免组件内大量判断。若用了 CSP,记得允许内联脚本或配置 hash。
“主题不是普通交互状态,它要在 HTML 可交互之前就正确出现。能进 SSR 的偏好,就别等到 mounted。”
小结
修完后,夜间模式首屏不再闪白,读者反馈也舒服多了。回头看,这类问题本质是“首屏状态一致性”:Cookie 负责让服务端知道,内联脚本负责抢在渲染前兜底,SSR 注水负责让初始 HTML 和客户端状态对齐。把三者的数据源统一,很多闪烁、跳动、登录态闪现都会好修。