暗黑模式实现与主题切换教程

本文深入剖析了暗黑模式在现代Web开发中真正落地的关键实践：必须协同运用`prefers-color-scheme`媒体查询（作为无JS、首屏即生效的系统级兜底）、`data-theme`属性（统一收口控制权，确保伪元素、第三方组件和SSR兼容性），以及`localStorage`持久化（锁定用户偏好，避免刷新回退或Safari闪屏）——三者缺一不可；同时厘清了`color-scheme`与`light-dark()`的辅助定位，点明表单控件、滚动条、图片SVG、OLED适配及旧WebView降级等高频翻车细节，直击“切得出来却用不稳”的核心痛点。

直接在 HTML 模板里实现可用的暗黑模式，核心不是“加个 dark class 就完事”，而是让 prefers-color-scheme 媒体查询打底、data-theme 属性接管控制权、localStorage 锁定用户选择——三者缺一不可。否则刷新就回亮色、切换后表单失色、Safari 下闪屏，全是常见翻车点。

怎么用 @media (prefers-color-scheme: dark) 设默认值

这是首次加载时最可靠的兜底逻辑：不依赖 JS，不等 DOM 就生效，且现代浏览器（Chrome 76+、Firefox 67+、Safari 12.1+）原生支持。

• 必须写在