17370845950

暗黑模式切换依赖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 实现手动切换

用户点击按钮切换时，应修改 或 的 data-theme 属性，再由 CSS 读取：

切换主题

• CSS 中用 html[data-theme="dark"] 覆盖变量值，比 class 更语义清晰
• 务必用 localStorage 持久化，否则刷新后重置
• 首次加载时要同时检查 localStorage 和 matchMedia，避免闪屏

避免内联样式和重复定义破坏主题一致性

一旦引入主题变量，就不要再写死颜色值，否则会绕过主题控制：

• ❌ 错误： —— 完全脱离主题系统
• ✅ 正确：，然后在 CSS 中定义 .card { background: var(--card-bg); }
• 所有颜色、阴影、边框粗细都应走 CSS 变量，包括 SVG 的 fill 和 stroke
• 第三方组件（如日期选择器）若不支持变量，需用 [data-theme="dark"] .third-party-class 单独覆盖

真正难的不是写几行切换代码，而是把整个项目里所有硬编码的颜色、背景、图标填充都归入变量体系——漏掉一个 #2d2d2d，就可能在暗黑模式下突然亮得刺眼。