CSS变量实现颜色切换方法详解

一分耕耘，一分收获！既然都打开这篇《CSS变量实现颜色切换教程》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新文章相关的内容，希望对大家都有所帮助！

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

本篇关于《CSS变量实现颜色切换方法详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！