火狐深色模式不生效需分步排查：先检查about:support中“操作系统”行是否含【dark】，再确认prefs.js存在；接着在about:config中设ui.systemUsesDarkTheme=1、widget.non-native-theme.enabled=true；然后重置主题设置并刷新；最后确保layout.css.prefers-color-scheme.content-override=2及browser.theme.content-theme=0。
火狐浏览器深色模式不生效，表现为地址栏仍是亮白、新标签页背景发灰、网页内容毫无变化，即使已勾选“跟随系统设置”或安装了Dark Reader，说明底层信号未送达、UI与内容层配置断裂或存在冲突项。
确认系统深色信号是否真正传入火狐
第一步：在地址栏输入 about:support 回车 → 滚动到“应用程序基础信息”下方的“操作系统”行 → 查看其值是否包含【dark】或【深色】字样。若显示 light、空白或 unknown，说明系统未向火狐进程发送深色信号，后续所有配置都无效。
第二步：点击同一页面中“配置文件夹”旁的“打开文件夹”按钮 → 在弹出的文件夹内检查是否存在 prefs.js 文件。若不存在，该配置文件已被删除或损坏，必须重建，跳至“强制启用系统主题同步”板块操作。
强制启用系统主题同步（无需重启）
方法一：通过 about:config 直接触发
1、地址栏输入 about:config → 点击“接受风险并继续”。
2、搜索 ui.systemUsesDarkTheme → 若值为 0，双击改为 1；若该项不存在，右键空白处 → “新建” → “布尔值” → 名称填 ui.systemUsesDarkTheme → 值设为 true。
3、再搜索 widget.non-native-theme.enabled → 确保其值为 true；若为 false，双击切换。
4、立即关闭 about:config 标签页，5 秒内观察地址栏右侧图标背景色是否变暗——变暗即表示系统深色信号已成功注入。
修复主题跟随逻辑断裂
① 打开火狐设置 → “常规” → “语言和外观” → “主题”，先将下拉菜单临时改为“明亮”，等待 2 秒；
② 再改回“Alpenglow Dark”或“系统”；
③ 向下滚动到“主题”设置下方，找到“跟随系统设置”选项，必须取消勾选后再重新勾选一次，否则火狐会缓存旧状态，导致开关形同虚设；
④ 此时不要关闭设置页，直接按 Ctrl+Shift+R 强制刷新当前设置页面，界面元素应立刻响应变化。
检查网页是否收到深色偏好声明
这一步决定 Dark Reader 能否正确启动动态分析起点，也影响 GitHub、知乎等原生支持站点是否自动启用暗色样式。
在地址栏输入 about:config → 点击“接受风险并继续” → 搜索 layout.css.prefers-color-scheme.content-override。
该项值必须为 2，否则网页收不到“用户偏好深色”的信号。若此项不存在，右键空白处 → 新建 → 整数 → 名称粘贴完整字段 → 值填 2。
验证 browser.theme.content-theme 是否生效
方法一：手动设定内容层强制深色
第一步：在 about:config 中搜索 browser.theme.content-theme。
第二步：双击该项，将值设为 0（0 = 强制深色，1 = 强制浅色，2 = 自动跟随系统）。
第三步：新开一个标签页，访问未适配的纯文本网页（如 GitHub raw 文件链接），观察主体内容区是否变为灰黑底色。
第四步：若无变化，再搜索 ui.systemUsesDarkTheme 和 layout.css.prefers-color-scheme.content-override，确认二者均为 1 和 2；任一不匹配都会导致此步失效。
