用 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:
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,就能做出体验完整的基础主题切换功能。










