@media (prefers-color-scheme: dark) 是唯一真正实现系统级自动切换的原生方案,无需 JS、按钮或 localStorage,浏览器在系统主题变更时直接重绘样式;但需确保变量在 :root 先定义默认值、暗色规则置于最后、加 color-scheme: light dark 声明,并兜底 no-preference 场景。

直接用 @media (prefers-color-scheme: dark) 就能实现系统级自动切换,不需要 JS、不依赖按钮、不读写 localStorage —— 浏览器在系统主题变更时会重绘样式,但前提是 CSS 写法和加载方式不出错。
为什么写了 @media (prefers-color-scheme: dark) 却没反应
根本不是浏览器不支持,而是 CSS 层叠或加载时机被破坏了:
- 把暗色规则写在亮色样式之前:CSS 后声明覆盖前声明,
@media块本身不提升优先级 - 用 JS 动态插入
或document.createElement('link'):部分浏览器(尤其旧版 Safari)不会触发媒体查询重匹配 - 嵌套在其他媒体查询里,比如
@media (max-width: 768px) { @media (prefers-color-scheme: dark) { ... } }:iOS 13.3 之前完全失效 - 漏了
:root的默认变量定义:系统设为no-preference或降级时,var(--bg)会 fallback 到浏览器默认值(比如白底黑字)
:root 变量怎么初始化才不翻车
所有主题变量必须在顶层 :root 中明确定义默认值(以亮色为基准),再用媒体查询整体覆盖:
:root {
--bg: #ffffff;
--text: #333333;
--border: #e0e0e0;
}
<p>@media (prefers-color-scheme: dark) {
:root {
--bg: #121212;
--text: #e0e0e0;
--border: #333333;
}
}</p><p>body {
background-color: var(--bg);
color: var(--text);
border-color: var(--border);
}
</p>
关键点:
- 变量名必须语义化且一致,不能一个叫
--bg-light、另一个叫--bg-dark - 不要用
!important覆盖变量,它会破坏可维护性 - iOS 13.3 以下 Safari 对
:root内部重定义有 bug,所以默认值一定要先写全
原生控件(表单、滚动条、SVG)为啥还是亮的
因为它们不自动读取 CSS 变量,也不响应你的 background-color 设置。必须显式告诉浏览器你支持双主题:
- 加
html { color-scheme: light dark; }:这是关键开关,让、、滚动条、自动适配系统色 - 用系统语义色替代硬编码值:比如
color: CanvasText;、background: Canvas;,它们随系统主题实时变化 - SVG 图标若用
fill,需额外加fill: currentColor;并确保父元素颜色已通过变量控制
移动端 WebView 和国产浏览器怎么兜底
WebView 支持有坑,国产浏览器兼容性更差,不能只靠一个媒体查询:
- Android WebView 需要同时满足两个条件才触发:
WebSettings.setForceDark(FORCE_DARK_ON)+ 系统深色开启;纯 CSS 不保证生效 - iOS WKWebView 默认继承系统偏好,但如果 Hybrid App 没声明
或禁用了颜色管理,可能 fallback 到no-preference - UC、QQ 浏览器旧版本直接忽略该查询,建议加一层兜底:
@media (prefers-color-scheme: no-preference) { :root { /* 明确亮色 */ } } - 开发调试时,Chrome DevTools → Rendering → Emulate CSS media feature →
prefers-color-scheme可手动切换测试
最易被忽略的是:系统主题切换后,已打开的页面不会自动重绘(除非刷新或监听 matchMedia 手动触发)。这不是 bug,是规范行为——prefers-color-scheme 是加载时快照,不是实时监听器。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











