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






























