实现暗黑模式的关键是通过CSS变量定义亮色与暗色主题，利用JavaScript动态切换class，并结合localStorage和prefers-color-scheme实现用户偏好记忆与系统自动适配，同时优化颜色对比度、图片显示及过渡动画以提升体验。
实现暗黑模式的关键在于动态切换页面主题，HTML5本身不直接支持主题切换，但结合CSS和JavaScript可以轻松完成。核心思路是通过CSS定义亮色与暗色两种样式，再用JavaScript根据用户偏好或手动操作切换。
1. 使用CSS变量定义主题颜色
CSS自定义属性（变量）让主题管理更灵活。在:root中定义默认（亮色）主题，再通过类名覆盖为暗色。
示例：
<font color="#0066cc">:root </font>{
--bg-color: #ffffff;
--text-color: #333333;
--header-bg: #f0f0f0;
}
.dark-mode {
--bg-color: #1a1a1a;
--text-color: #e0e0e0;
--header-bg: #2d2d2d;
}
body {
background-color: var(--bg-color);
color: var(--text-color);
transition: background-color 0.3s ease;
}
header {
background-color: var(--header-bg);
}
2. JavaScript控制主题切换
通过JavaScript操作class来激活暗黑模式。可绑定按钮点击事件，或读取系统偏好。
立即学习“前端免费学习笔记（深入）”；
常见实现方式：
- 添加一个切换按钮，点击时给body添加或移除dark-mode类
- 使用localStorage保存用户选择，刷新后仍保持
- 检测系统设置：prefers-color-scheme媒体查询
代码示例：
const body = document.body;
const toggleBtn = document.getElementById('theme-toggle');
// 检查本地存储或系统设置
if (localStorage.getItem('theme') === 'dark' ||
(!localStorage.getItem('theme') &&
window.matchMedia('(prefers-color-scheme: dark)').matches)) {
body.classList.add('dark-mode');
}
toggleBtn.addEventListener('click', () => {
body.classList.toggle('dark-mode');
const theme = body.classList.contains('dark-mode') ? 'dark' : 'light';
localStorage.setItem('theme', theme);
});
3. 自动适配系统偏好
利用window.matchMedia监听系统主题变化，实现自动同步。
可添加监听器，在用户更改系统设置时自动更新页面：
window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', e => {
if (!localStorage.getItem('theme')) {
if (e.matches) {
body.classList.add('dark-mode');
} else {
body.classList.remove('dark-mode');
}
}
});
这样既尊重用户系统设置，又允许手动覆盖，体验更友好。
4. 优化细节提升体验
主题切换不只是背景和文字颜色。注意以下几点：
- 图片或图标在暗色背景下可能看不清，可使用CSS滤镜或准备两套资源
- 加入过渡动画，避免颜色突变造成视觉不适
- 按钮、输入框等表单元素也需适配暗色主题
- 确保对比度符合可访问性标准（WCAG）
基本上就这些。不复杂但容易忽略细节。只要结构清晰，维护两套CSS变量，再用JS控制开关，就能实现流畅的暗黑模式切换。
