Dark Reader 完整指南:让每个网站都有暗黑模式的 6 个关键节点
【免费下载链接】darkreaderDark Reader Chrome and Firefox extension项目地址: https://gitcode.com/gh_mirrors/da/darkreader
Dark Reader 是一款开源免费的浏览器扩展,能把任意网页实时转换成暗黑模式,支持 Chrome、Firefox、Edge 三个浏览器。它不是简单地把颜色反转,而是分析每个网站自己的 CSS 与 DOM 结构,生成一份专属的暗色配色,文字可读、图片不变形。适合夜间大量阅读文档、新闻的读者,以及想按站点逐项微调的开发者。
🌙 核心能力拆解:暗黑模式引擎的 5 个可调点
按站生成主题:默认的 dynamic 引擎读取页面的 CSS 与 DOM 结构,为每个站点独立计算背景色和文字色。访问文档站和新闻站会得到两套不同的暗色组合,不需要手动逐站调。
三种渲染引擎:dynamic、filter、static 三种模式可以在弹窗里切换。在线办公工具在 dynamic 下出现白底残留时,把该站点单独切到 filter 引擎即可快速兜底。
按站保存设置:亮度、对比度、灰度、棕色调都支持按域名保存。给工作后台单独调高对比度,其他站点保持默认值,互不干扰。
自动化开关:支持在指定时间段自动启用(默认 18:00 到次日 9:00),也可以跟随系统深色模式联动。夜间自动开启、白天自动关闭,不用每天手动点。
按站排除名单:可以列出保持原样的域名。仓库内置了一份 1300 多条的默认排除名单,位于src/config/dark-sites.config,这些站点打开时不注入暗黑样式。
以上 5 项能力全部在 Dark Reader 的弹窗和设置页里能直接操作,不需要写任何代码。
🚀 3 分钟跑通:从安装到生效的最短路径
- 安装:打开所用浏览器的扩展商店,搜索 Dark Reader,点击安装。装好后工具栏出现插件图标。
- 验证生效:点击图标打开弹窗,确认"深色模式"开关处于开启状态,当前页面立即切换为深色背景。
- 基础调节:在同一弹窗里把亮度拖到 70~80,对比度保持在 90 以上,页面观感立刻柔和下来。
- 按站保存:调好后点击按站保存,设置只对当前域名生效,其他站点不受影响。
- 配置快捷键:默认 Alt+Shift+D 全局开关,Alt+Shift+A 只针对当前站点切换,适合频繁在深浅主题间来回切的用户。
🎛 深度配置:按站微调的 5 个进阶技巧
- 统一浏览器与编辑器的色调
- 场景:开发者希望浏览器的底色和代码编辑器的暗色方案一致,减少来回切换时的视觉落差。
- 操作:在设置里从预设配色列表中挑选方案,配色定义存放在
src/config/color-schemes.drconf,内置 Dracula、Nord、Tokyo Night 等,格式长这样:
Default DARK background: #181a1b text: #e8e6e3- 效果:整台浏览器的底色和编辑器对齐,长时间对照写代码时眼睛不容易累。
切换渲染引擎修复白底残留
- 场景:一个复杂单页应用侧边栏在 dynamic 引擎下残留白色背景。
- 操作:在弹窗的主题生成模式里,把当前站点单独切到 static 或 filter 引擎。
- 效果:static 用固定预设配色,颜色最稳定;filter 转换速度最快,复杂页面更不容易出错。
处理文字刺眼的站点
- 场景:某站点默认亮度 100,转出来的文字依然太亮。
- 操作:只对该站点把亮度降到 70~80,对比度维持在 90 以上,然后按站保存。
- 效果:该站点文字变柔和可读,其余站点保持原来的亮度。
给渲染异常的站点手动兜底
- 场景:某站点出现黑底黑字、整块不可读的情况。
- 操作:在设置中为该域名添加手动主题覆盖,自行指定背景色与文字色。
- 效果:排版恢复可读,且修复只作用于这个域名,刷新后依然生效。
资源密集型站点减负
- 场景:视频、流媒体站点在开启后出现掉帧、播放卡顿。
- 操作:为该域名关闭暗黑模式,或把它切到 filter 引擎。
- 效果:播放恢复流畅,其他页面不受任何影响。
⚖️ 横向对比:Dark Reader 与 Night Eye 怎么选
| 对比维度 | Dark Reader | Night Eye(Firefox 内置) |
|---|---|---|
| 功能覆盖 | 按站设置、三种渲染引擎、定时与系统联动、预设配色方案 | 全局色温调节,少量页面级微调 |
| 上手成本 | 安装即用,基础设置 3 分钟内完成 | 无需安装,但可调项有限 |
| 性能表现 | 逐页注入脚本,内存开销略高于全局滤镜 | 全局滤镜方案,开销最小 |
| 社区活跃度 | 开源项目持续发版,站点修复名单定期更新 | 随 Firefox 版本更新,无独立社区 |
如果你主要用来按站点精细微调并在多浏览器间保持一致,选 Dark Reader 更合适;如果侧重全局降蓝光的轻量处理,Night Eye 是更优解。
🧯 高频踩坑与解法
某些页面残留白底。原因通常是站点自身 CSS 优先级更高,或内容用 canvas、WebGL 绘制,不在 CSS 注入范围内。如果你也遇到过这种情况,先把该站点切到 filter 或 static 引擎试试;整页都是 canvas 的站点,注入类方案本身就有局限,给这个站关掉更稳妥。
转暗后文字依然刺眼。默认亮度是 100,高对比度站点的转换结果会偏亮。把亮度降到 70~80、对比度保持在 90 以上,大多数页面就会变得柔和且可读,然后记得按站保存。
PDF 或登录页没有生效。默认配置对 PDF 是开启的,但受保护页面(银行、邮箱登录这类)出于安全考虑默认不开启。可以在设置里打开"对受保护页面启用",不过涉及支付、验证码的操作建议保留原样,避免干扰页面行为。
换了电脑设置全丢。设置默认存在本机浏览器里,不会自动搬家。在设置页导出配置文件,换机后导入即可;或者打开同步开关,让浏览器账号帮你带走所有按站设置。
某个站点看起来没开暗黑。它很可能在排除名单里,默认就没有启用。手动把该站点加入启用列表,或者先确认站点自己的主题设置没有盖掉插件的样式,两种途径都能恢复。
🔧 生态、集成与开发
Dark Reader 覆盖 Chrome、Firefox、Edge、Thunderbird 四个平台,界面提供 40 多种语言。站点修复规则会定期同步更新,在设置里打开同步站点修复后,新的修复无需手动导入。
从开发者视角看,背景逻辑在src/background/,注入页面做 CSS 重写的代码在src/inject/,两套目录职责分明,配合主题引擎生成器完成整套转换。想从源码构建时:
git clone https://gitcode.com/gh_mirrors/da/darkreader cd darkreader && npm install npm run build构建完成后在build/release/目录里取对应浏览器的扩展,用"加载已解压的扩展程序"安装即可。移动端同样支持,Firefox 安卓版上装好后,手机夜间浏览也能用同一套设置。
✍️ 写在最后
把每个站点自己的 CSS 转换成按站可调的暗色配色,是这款工具最核心的价值。现在就去装一个,挑一个夜间阅读困难的网站先试起来。遇到效果不好的站点,也欢迎向社区提交修复建议或直接贡献 PR。
【免费下载链接】darkreaderDark Reader Chrome and Firefox extension项目地址: https://gitcode.com/gh_mirrors/da/darkreader
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考