TIP 10 · DARK MODE

网站不跟随系统深色模式了?和 Claude 一起查一个「记性太好」的 bug

系统已经切到深色,灵点AI 却还亮着;用无痕窗口打开,又是好的。
这一期和 Claude 一起把这个 bug 查清楚:问题不在颜色,而在一个按钮的「记性」。

Claude深色模式排查思路localStorage第 10 期
同一个页面的亮色和暗色版本,以及被改掉的主题记录
灵点AI 约 6 分钟读完 最后验证 2026.10.14
本篇目录

灵点AI 有亮色和暗色两套配色,默认跟随系统:手机或电脑切到深色模式,网站也跟着变暗。右上角还有一个按钮,可以手动切换。

有一天我们发现:系统已经是深色了,网站却还是亮的。用浏览器的无痕窗口打开,又是好的。

这种「有时好有时坏」的 bug 最难描述。这一期讲我们怎么和 Claude 一起把它查清楚。

先把现象说清楚

交给 Claude 之前,先把能确定的线索整理出来:

系统开了深色模式,灵点AI 还是亮色;同一个浏览器开无痕窗口打开,就是正常的暗色。之前点过右上角的主题切换按钮。

「无痕窗口里正常」是第一条关键线索。无痕窗口不带任何旧记录,它正常,说明网站的配色本身没问题,问题出在浏览器自己记住的东西上。「点过按钮」则直接指向了嫌疑人。

所以遇到「有时好有时坏」的页面问题,先用无痕窗口打开一次,是个很省事的排查办法。

原因:按钮把一次点击永远记住了

Claude 读完主题切换的代码,很快找到了原因。

主题其实有三种状态:亮色、暗色、跟随系统。网站第一次打开时没有任何记录,就按「跟随系统」显示。但旧的切换按钮只会在亮色和暗色之间来回切,而且每点一次,都会把选择存进浏览器(localStorage 里一条叫 w-theme 的记录)。

于是,只要点过一次按钮,这个浏览器就永远停在那个颜色上。系统再怎么切,网站都不动了;而且页面上没有任何入口能回到「跟随系统」。

旧按钮和新按钮的区别

这就解释了为什么无痕窗口里是好的:那里没有这条记录。换一个从没点过按钮的浏览器,也一样正常。

修改一:切回和系统一样的颜色,就恢复跟随系统

最直接的修法,是再加一个「跟随系统」按钮,但导航栏又要多一个按钮。

Claude 给的方案是:点击按钮时,如果要切到的颜色正好和系统一样,就不记成「亮色」或「暗色」,而是直接恢复「跟随系统」。

const next = root.dataset.theme === 'dark' ? 'light' : 'dark';
const sys = media.matches ? 'dark' : 'light';
change(next === sys ? 'system' : next, true, button);

举个例子:系统是深色,你手动切成亮色,这个选择会被记住;你再点一下切回深色,正好和系统一样,于是记录变回「跟随系统」。以后系统怎么变,网站就怎么变。

修改二:给老访客清一次旧记录

光改按钮还不够。已经点过旧按钮的访客,浏览器里留着旧记录,照样不跟随系统。

所以 Claude 加了一个版本号 w-theme-v。页面打开时先看一眼:如果版本号不是 2,就把旧的主题记录清掉,再写上新版本号。

if (localStorage.getItem('w-theme-v') !== '2') {
localStorage.removeItem('w-theme');
localStorage.setItem('w-theme-v', '2');
}

这段只会在每个浏览器里执行一次。清完以后,所有老访客都回到「跟随系统」,之后再手动切换,就按新规则记住。

这是改「会被记住的东西」时很容易漏掉的一步:新代码只对新访客生效,老访客身上还带着旧数据。

修改三:系统一变,马上跟着变

最后两处小改动,让「跟随系统」名副其实:

  • 监听系统配色的变化:处于跟随系统状态时,傍晚手机自动切到深色,网站不用刷新就跟着变;
  • 监听其他标签页的改动:在一个标签页里切了主题,同时开着的其他灵点AI 页面也一起变。

按钮的提示文字也改了。鼠标停在按钮上,会显示「跟随系统中(当前暗色),点击固定为亮色」,或者「已固定为亮色,点击恢复跟随系统」。现在是什么状态、点了会怎样,一眼就能看明白。

改完怎么验证

Claude 改完以后,我们按这张清单逐条试了一遍:

  • 清空记录后打开:跟随系统;
  • 系统是深色时点按钮:变亮,刷新后还是亮;
  • 再点一次:变暗,并且恢复跟随系统,切换系统配色时网站跟着变;
  • 开两个标签页,在一个里切换:另一个同步变化。

验证时有个小技巧:在浏览器开发者工具的控制台里,可以直接查看当前记录了什么:

localStorage.getItem('w-theme')

返回 null 或 system,说明正在跟随系统。

向 AI 描述 bug,可以照这个顺序

这次能很快查到原因,是因为第一句话里就带上了关键线索。描述 bug 时可以套这个顺序:

现象:我看到了什么(系统深色,网站亮色)
环境:在哪里出现,在哪里不出现(普通窗口有,无痕窗口没有)
操作:出问题之前我做过什么(点过切换按钮)
期望:正确的样子应该是什么(跟随系统,手动切换后能恢复)

这次学到的

  • 「无痕窗口里就好」的 bug,先怀疑浏览器记住的旧数据。
  • 状态有三种,按钮只能切两种,就会有一种状态「进去了出不来」。
  • 改了会被记住的数据,要给老访客迁移一次,不然修复只对新访客生效。
  • 给 AI 报 bug,别只说「坏了」,把现象、环境、操作和期望一起说清楚。