暗黑模式与系统主题区别详解

本文深入解析了HTML暗黑模式与操作系统主题的本质区别：网页无法改变系统设置，只能通过只读的`prefers-color-scheme`媒体查询响应瞬时系统偏好，而真正主导页面主题的是用户主动选择并持久化的`data-theme`属性——它才是权威主题源，需在DOM就绪前同步设置、更新``、`localStorage`及CSS变量，并通过事件机制实现跨标签页一致性；忽视初始化顺序、监听缺失、CSS兜底不足或混淆系统快照与用户意图，都会导致闪屏、不同步、样式失效等典型问题。

HTML暗黑模式不能改善系统主题，它只响应、不改变——网页无法控制操作系统或浏览器的深色/浅色设置，只能读取（prefers-color-scheme）或覆盖（data-theme）自己的样式表现。

prefers-color-scheme 是只读的“快照”，不是双向通道

这个 CSS 媒体查询只反映当前系统设置的瞬时状态，比如 macOS 的“自动”模式在夜间触发 dark，Windows 10/11 的“自动”则通常返回手动设定值，而非真实时间逻辑。它不提供 API 修改系统偏好，也不监听运行时变化（除非配合 window.matchMedia().addEventListener("change", ...)）。

常见错误现象：
- 页面首次加载按系统变暗了，但用户后来在系统设置里切回亮色，网页没反应 → 忘了加 change 监听；
- 开发者工具里强制启用 dark 模式，但页面没变 → CSS 规则写在了