用 CSS 变量实现主题切换：1. 在 :root 定义基础变量；2. 通过 .dark 类覆盖变量值；3. JS 切换 class 并存 localStorage；4. 用 prefers-color-scheme 自动适配系统偏好。
用 CSS 变量（Custom Properties）实现颜色主题切换，是现代前端开发中轻量、灵活又易维护的方式。核心思路是：把颜色等可变值定义为 CSS 变量，放在 :root 或某个作用域内；再通过 JavaScript 切换 class 或修改变量值，让样式自动响应变化。
1. 定义基础 CSS 变量
在 :root 中统一声明主题色、背景色、文字色等，方便全局复用：
:root {
--primary-color: #4285f4;
--bg-color: #ffffff;
--text-color: #333333;
--card-bg: #f9f9f9;
--border-color: #e0e0e0;
}
这些变量可在任意选择器中使用，比如：
button {
background-color: var(--primary-color);
color: white;
}
body {
background-color: var(--bg-color);
color: var(--text-color);
}
2. 创建深色/浅色主题 class
不直接改变量，而是用 class 控制不同主题下的变量值，更清晰可控：
立即学习“前端免费学习笔记（深入）”；
:root {
--primary-color: #4285f4;
--bg-color: #ffffff;
--text-color: #333333;
--card-bg: #f9f9f9;
}
:root.dark {
--primary-color: #66b2ff;
--bg-color: #1e1e1e;
--text-color: #e0e0e0;
--card-bg: #2d2d2d;
}
这样只需给 或 切换 dark class，整站风格就自动更新。
3. 用 JavaScript 切换主题
加个按钮，点击时切换 class，并保存用户偏好到 localStorage：
<button id="theme-toggle">切换主题</button>
const html = document.documentElement;
const toggleBtn = document.getElementById('theme-toggle');
// 初始化：读取本地存储或系统偏好
const savedTheme = localStorage.getItem('theme') || 'light';
if (savedTheme === 'dark') {
html.classList.add('dark');
}
toggleBtn.addEventListener('click', () => {
html.classList.toggle('dark');
const isDark = html.classList.contains('dark');
localStorage.setItem('theme', isDark ? 'dark' : 'light');
});
4. 可选：适配系统偏好（自动跟随深色模式）
用 prefers-color-scheme 媒体查询做默认 fallback：
@media (prefers-color-scheme: dark) {
:root:not(.dark) {
--primary-color: #66b2ff;
--bg-color: #1e1e1e;
--text-color: #e0e0e0;
--card-bg: #2d2d2d;
}
}
这样用户没手动设置时，会按系统设置自动启用深色主题；一旦用户手动切换，class 优先级更高，覆盖媒体查询。
不复杂但容易忽略细节：CSS 变量是动态的，支持继承和层叠；修改后所有引用自动重绘，无需刷新页面；搭配 localStorage 和 prefers-color-scheme，就能做出体验完整的基础主题切换功能。
