暗黑模式切换依赖CSS变量、prefers-color-scheme媒体查询和JavaScript控制类名，HTML5不提供原生支持；需统一使用CSS变量定义所有颜色、阴影等样式，并持久化至localStorage，避免硬编码破坏主题一致性。
暗黑模式切换不是靠改 HTML 结构实现的，而是靠 CSS 变量 + prefers-color-scheme 媒体查询 + JavaScript 控制类名切换。HTML5 本身不提供“暗黑布局代码”，所有样式逻辑必须落在 CSS 和 JS 层。
用 prefers-color-scheme 自动适配系统偏好
这是最轻量、无需 JS 的基础支持方式，浏览器自动识别系统设置：
@media (prefers-color-scheme: dark) {
:root {
--bg-color: #121212;
--text-color: #e0e0e0;
}
}
@media (prefers-color-scheme: light) {
:root {
--bg-color: #ffffff;
--text-color: #333333;
}
}
body {
background-color: var(--bg-color);
color: var(--text-color);
}
- 仅响应系统级设置，用户无法手动切换
- 必须把变量定义在
:root，否则子元素无法继承 - 部分旧版 Safari（prefers-color-scheme，需降级 fallback
用 data-theme 属性 + JS 实现手动切换
用户点击按钮切换时，应修改 <html> 或 <body> 的 data-theme 属性，再由 CSS 读取：
<button id="theme-toggle">切换主题</button>
<script>
const html = document.documentElement;
const saved = localStorage.getItem('theme');
if (saved) {
html.dataset.theme = saved;
} else if (window.matchMedia('(prefers-color-scheme: dark)').matches) {
html.dataset.theme = 'dark';
}
document.getElementById('theme-toggle').addEventListener('click', () => {
const current = html.dataset.theme;
const next = current === 'dark' ? 'light' : 'dark';
html.dataset.theme = next;
localStorage.setItem('theme', next);
});
</script>
- CSS 中用
html[data-theme="dark"]覆盖变量值，比 class 更语义清晰 - 务必用
localStorage持久化，否则刷新后重置 - 首次加载时要同时检查
localStorage和matchMedia，避免闪屏
避免内联样式和重复定义破坏主题一致性
一旦引入主题变量，就不要再写死颜色值，否则会绕过主题控制：
立即学习“前端免费学习笔记（深入）”；
- ❌ 错误：
<div style="background:#1e1e1e">—— 完全脱离主题系统 - ✅ 正确：
<div class="card">，然后在 CSS 中定义.card { background: var(--card-bg); } - 所有颜色、阴影、边框粗细都应走 CSS 变量，包括 SVG 的
fill和stroke - 第三方组件（如日期选择器）若不支持变量，需用
[data-theme="dark"] .third-party-class单独覆盖
真正难的不是写几行切换代码，而是把整个项目里所有硬编码的颜色、背景、图标填充都归入变量体系——漏掉一个 #2d2d2d，就可能在暗黑模式下突然亮得刺眼。
