✅ 正确方式是将 CSS 变量定义在 :root 下,再用 @media (prefers-color-scheme: dark) 重设变量值;必须提供回退值,配合 JS 切换时以 data-theme 为主,media 查询仅作系统偏好兜底。

直接用 @media (prefers-color-scheme: dark) 声明 CSS 变量就能自动响应系统偏好,但必须写在 :root 下且不能嵌套——这是最轻量、无需 JS 就能生效的方式。
变量必须定义在 :root 里,且不能放在媒体查询内部
浏览器只允许在顶层作用域(即 :root)中声明变量,@media 块内写 :root { --color: #000 } 是非法语法,整条规则会被忽略。
- ✅ 正确写法:
:root { --text: #333; }<br>@media (prefers-color-scheme: dark) { :root { --text: #eee; } } - ❌ 错误写法:
@media (prefers-color-scheme: dark) { :root { --text: #eee; } }(无效)
或@media (prefers-color-scheme: dark) { :root { --text: #eee; } }(重复写法,仍无效)
所有用到变量的地方都要加回退值
CSS 变量未定义时会降级为 inherit 或初始值,导致颜色错乱或元素不可见。尤其在媒体查询刚加载、变量尚未注入时容易出问题。
Lightning CSS 是由 Parcel 团队开发的基于 Rust 的 CSS 解析器、转换器、打包工具和压缩工具。此技能适用于需要优化样式表、为目标浏览器降低现代 CSS 语法以及将快速 CSS 处理集成到构建或重构工作流中的代理。
- 写法示例:
color: var(--text, #333);background: var(--bg, #fff);border-color: var(--border, #ddd); - box-shadow、outline 等带透明度的属性,也要注意暗色模式下是否需补 rgba 或调整 alpha
配合 JS 手动切换时,media 查询只是兜底,不是主力
prefers-color-scheme 只反映系统设置,用户主动点“深色模式”按钮后,得靠 JS 修改 document.documentElement.setAttribute('data-theme', 'dark') 并同步变量——此时 media 查询不会触发更新。
立即学习“前端免费学习笔记(深入)”;
- 推荐结构:用
html[data-theme="dark"]覆盖变量,优先级高于 media 查询 - 初始化逻辑应为:
先读localStorage→ 没有则查matchMedia('(prefers-color-scheme: dark)').matches→ 设定data-theme并更新:root变量 -
<meta name="color-scheme" content="light dark">必须存在,否则 Safari/Chrome 表单控件不随主题变色
过渡动画要谨慎加,避免重绘卡顿
变量本身不触发重排,但 color、background 等属性变化若没加 transition,切换会生硬;加了又可能因浏览器渲染策略导致闪烁或延迟。
- 建议只对低开销属性加过渡:
transition: color 0.2s, background-color 0.2s; - 避开
border、box-shadow、transform等易引发重绘的属性 - contenteditable 编辑器等高频交互区域,可加
will-change: background-color提前提示渲染引擎


















