·更新于 2026年11月22日· 47 次浏览 Nuxt3Vue3SSRCookieBUG解决前端性能

Nuxt 3 博客夜间模式首屏闪白:我用 Cookie、内联脚本和 SSR 注水修复主题闪烁

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

Nuxt 3 博客夜间模式首屏闪白:我用 Cookie、内联脚本和 SSR 注水修复主题闪烁 封面
ZHOUYI

作者

ZHOUYI

前阵子有读者反馈,晚上打开博客,内容还没出来,先被一整块白色闪到。我自己夜里复现,确实像有人拿手电筒晃了一下。问题不在样式表加载慢,而是主题偏好没在服务端、Cookie 和客户端激活之间对上。

闪白的根源

最开始的实现是 mounted 后读 localStorage,再给 html 加 dark 类。SSR 输出的 HTML 只能按默认浅色渲染,浏览器先拿到浅色页面,等 JS 执行才切深色。中间这段空档,就是闪白。若偏好存在 Cookie,服务端能读到,但客户端水合时又只看 localStorage,也会出现两边不一致。

  • 只存 localStorage:服务端渲染读不到
  • 只靠客户端插件切换:晚于首屏绘制
  • Cookie、状态、系统偏好来源不统一:水合后反复修正

我最后的修法

思路很简单:主题偏好优先落到 Cookie,服务端按 Cookie 渲染初始类名;同时在 head 里放一段内联脚本,在 Vue 激活前读 Cookie 并设置 dark 类;客户端插件只负责同步 UI 状态,不再首屏改主题。若用户选“跟随系统”,脚本会读取 prefers-color-scheme,并把最终结果写回 Cookie,避免服务端瞎猜导致水合不一致。

ts
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 和客户端状态对齐。把三者的数据源统一,很多闪烁、跳动、登录态闪现都会好修。

Guestbook

留言

若这篇文章也曾停在你心上,留一行字吧,我会看的。

先确认一下邮箱

多这一步,是为了少些机器骚扰,也让我能更踏实地读每一条真人写下的字。验证码 10 分钟内有效;同一邮箱 60 秒内只能发一封。

本文留言

共 0 条已加载 0 条

这里还静悄悄的——愿意做第一个留下脚印的人吗?