@media (prefers-color-scheme: dark) 是唯一原生响应系统暗黑模式的 CSS 方案,无需 JS 或重载,但需确保 WebView 透传偏好、避免 @import 和嵌套、配合 color-scheme 声明及 :root 变量定义方可生效。

@media (prefers-color-scheme: dark) 是唯一能直接响应系统暗黑模式的 CSS 原生方案,不需要 JS、不依赖 localStorage、不触发页面重载——但只在支持它的 WebView 或浏览器中生效。
为什么 @media (prefers-color-scheme: dark) 在某些移动端打不开
不是你写错了,而是容器没透传系统偏好。iOS 的 WKWebView 默认不启用自动主题识别,需原生层显式设置 webView.configuration.defaultWebpagePreferences.preferredContentMode = .recommended(即 UIUserInterfaceStyleUnspecified);Android WebView 则要求目标 SDK ≥ 29 且开启 WebSettings.setForceDark(WebSettings.FORCE_DARK_ON),否则 window.matchMedia('(prefers-color-scheme: dark)') 返回 false 即使系统已开深色模式。
- Chrome for Android 85+、Safari iOS 13.4+ 原生支持,但 iOS 13.3 及更早版本首次加载会取错初始值
- 不要用
@import引入含该媒体查询的 CSS 文件——@import后的规则会被忽略 - 避免嵌套写法如
@media (max-width: 768px) and (prefers-color-scheme: dark),部分旧版 WebView 解析失败
如何让图片/图标也适配暗黑模式
CSS 媒体查询本身不切换 的 src,但可通过 picture + media 属性或 CSS 背景图变量实现资源级响应:
- 用
:在中指定暗色图标,fallback 用 - 用 CSS 背景图:定义
:root { --icon-url: url(light.svg); },再在@media (prefers-color-scheme: dark)里覆盖为--icon-url: url(dark.svg),然后background-image: var(--icon-url) - 慎用
filter: invert(1) hue-rotate(180deg)—— 它会翻转所有颜色,破坏图标语义(比如红色警告变青色),且对 PNG 透明通道异常敏感
暗黑模式下哪些 CSS 值最安全
硬编码颜色如 #121212 或 #e0e0e0 在高对比度模式或 OLED 屏上可能失效。优先使用系统语义色关键词:
-
Canvas替代#1e1e1e,CanvasText替代#e0e0e0,它们随系统主题和辅助功能设置联动 - 必须声明
color-scheme: light dark在:root或body上,否则、等表单控件仍按亮色渲染边框和焦点环 - 避免用
rgb()直接调色;现代浏览器支持lab(20% 0 0),能保持亮度层级,比rgb(30, 30, 30)更易控制 WCAG AA 对比度
为什么切了系统主题,页面样式没更新
这不是 bug,是规范行为:@media (prefers-color-scheme) 只在页面加载时读取一次系统值,**不会监听后续变更**。用户切换系统主题后,已打开的页面不会自动重绘——除非刷新,或你主动监听:
- 用
window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', ...)捕获变化(注意:iOS WKWebView 和部分 Android WebView 不触发该事件) - 若需强一致,可在监听到 change 后强制重设
document.documentElement.className并触发 CSS 变量重计算 - 开发调试时,Chrome DevTools → Rendering → Emulate CSS media feature 可模拟切换,但无法替代真机测试
真正容易被忽略的是:CSS 变量必须定义在 :root 下才能被媒体查询覆盖;写在 .card 之类局部选择器里,媒体查询根本不会管它。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











