CSS变量配合Sass实现多主题切换：1. Sass中用map定义各主题色值并生成[data-theme]规则；2. CSS中统一使用var(--xxx)引用；3. JS控制data-theme属性切换并持久化；4. :root设默认值兜底。
用 CSS 变量（Custom Properties）配合预处理器（如 Sass/Less）实现多主题切换，核心思路是：把主题色、字体、间距等可变值抽离为 CSS 变量，在顶层（如 :root）定义默认值；再为不同主题（如 data-theme="dark"）重写这些变量；预处理器负责结构化管理主题配置、生成对应类名和变量映射，提升可维护性。
1. 定义主题变量配置（预处理器层）
在 Sass 中，用 map 组织各主题的样式值，避免硬编码重复：
$themes: (
light: (
bg: #fff,
text: #333,
primary: #007bff,
border: #e0e0e0,
),
dark: (
bg: #121212,
text: #e0e0e0,
primary: #64b5f6,
border: #333,
),
blue: (
bg: #e3f2fd,
text: #1a237e,
primary: #1976d2,
border: #90caf9,
)
);
接着遍历 map，为每个主题生成对应的 [data-theme="xxx"] 规则块，并注入变量：
@each $theme-name, $theme-map in $themes {
[data-theme="#{$theme-name}"] {
--bg: map-get($theme-map, bg);
--text: map-get($theme-map, text);
--primary: map-get($theme-map, primary);
--border: map-get($theme-map, border);
}
}
编译后会输出类似：
立即学习“前端免费学习笔记（深入）”；
[data-theme="dark"] {
--bg: #121212;
--text: #e0e0e0;
--primary: #64b5f6;
--border: #333;
}
2. 在 CSS 中使用变量（运行时层）
所有组件样式直接引用 CSS 变量，不写死颜色或尺寸：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
body {
background-color: var(--bg);
color: var(--text);
font-family: system-ui, sans-serif;
}
.btn {
background-color: var(--primary);
border: 1px solid var(--border);
color: var(--text);
}
.card {
background: var(--bg);
border: 1px solid var(--border);
}
这样，只要切换 document.documentElement.dataset.theme = 'dark'，所有使用 var(--xxx) 的样式会自动响应更新。
3. 主题切换与持久化（JS 配合）
JavaScript 负责触发切换并保存用户偏好：
- 读取 localStorage 或 prefers-color-scheme 初始值
- 设置
document.documentElement.setAttribute('data-theme', 'dark') - 监听系统主题变化（
window.matchMedia('(prefers-color-scheme: dark)')）并同步 - 提供按钮调用
switchTheme('blue')并存入 localStorage
注意：CSS 变量支持继承和动态计算，比如 --text-inverted: color-mix(in srgb, var(--text) 50%, white);（现代浏览器），可进一步拓展主题表现力。
4. 预处理器增强技巧（可选）
提升开发体验的小技巧：
- 用 Sass 函数封装常用逻辑，如
theme-color('primary', 'dark')返回深色主题下的主色，用于构建非 CSS 变量场景（如内联 SVG fill） - 导出 JSON 主题配置，供 JS 运行时读取（如 i18n 或动态样式注入）
- 用
@use "sass:meta"实现主题校验，确保每个主题 map 包含必需 key
不复杂但容易忽略：确保 :root 中有默认变量值（防 JS 未加载或主题属性缺失），例如 :root { --bg: #fff; --text: #333; }，作为降级兜底。
