主题换肤基于Sass编译期变量注入与map批量生成，通过语义化主题变量（如$primary）、多主题文件赋值、@each遍历map输出CSS类及嵌套map定义颜色状态，避免运行时拼接与硬编码。
主题换肤不是靠 JS 切 CSS 文件，而是靠 Sass 编译期变量注入 + map 结构批量产出多套样式。核心是把“主题”变成可交换的值容器，而不是运行时拼字符串。
用 $theme 变量控制全局颜色体系
别在每个组件里写 color: #3b82f6，改用语义化主题变量：$primary、$bg-base、$text-emphasis。这些变量统一定义在 _theme.scss 里，不同主题文件（light.scss、dark.scss）只负责给它们赋值：
-
$primary: #3b82f6（亮色主题） vs$primary: #60a5fa（深色主题） - 所有组件样式都引用
$primary，换主题只需换引入的主文件 - 避免在变量里写
!important或rgba($primary, .8)这类带逻辑的表达式——它们该出现在具体选择器中，而非变量定义处
@each 遍历 theme map 批量生成主题类
当需要支持 .theme-light 和 .theme-dark 切换类时，不能手写两套规则。用 map 存主题配置，再用 @each 批量输出：
$themes: (
light: (
bg: #ffffff,
text: #1f2937,
),
dark: (
bg: #111827,
text: #f9fafb,
)
);
@each $theme-name, $theme-map in $themes {
.theme-#{$theme-name} {
--bg: #{map-get($theme-map, bg)};
--text: #{map-get($theme-map, text)};
background-color: map-get($theme-map, bg);
color: map-get($theme-map, text);
}
}
- 键名
light/dark必须加引号（字符串键），否则 Sass 报错Undefined variable "light" -
map-get()的第二个参数必须是字面量（如bg），不能是变量，否则编译失败 - 若需导出 CSS 变量（
--bg），得用插值#{...}包裹，否则会原样输出map-get(...)
嵌套 map 实现颜色层级与状态变体
单一 $primary 不够用？比如按钮悬停要加深、禁用要灰掉——这时得用嵌套 map：
Miller CSV TSV JSON 数据处理器
下载
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
立即学习“前端免费学习笔记（深入）”；
$colors: (
primary: (
DEFAULT: #3b82f6,
HOVER: #2563eb,
DISABLED: #93c5fd,
),
success: (
DEFAULT: #22c55e,
HOVER: #16a34a,
)
);
@each $color-name, $states in $colors {
@each $state, $value in $states {
.#{$color-name}-#{$state} {
background-color: $value;
}
}
}
- 状态名（
HOVER）全大写是约定，避免和变量名冲突；小写hover在 Sass 里可能被误认为函数 - 嵌套 map 要求 Sass ≥ 3.3，旧项目需确认版本，否则
map-get($states, HOVER)会报错 - 别用
@for $i from 1 to length($states)去遍历——map 没索引，@each是唯一安全方式
生成主题开关类时绕开 CSS 选择器权重陷阱
直接写 .theme-dark .btn 容易被组件内联样式或更高权重规则覆盖。更稳的做法是让主题类自身携带完整样式：
- 不依赖父级作用域，每个
.theme-dark .btn都显式声明所有属性，哪怕和默认一样 - 用
@include复用基础样式块，但主题类里必须调用，不能只靠继承 - 若用 CSS 变量做 fallback（如
color: var(--text, #1f2937)），确保 JS 注入时变量名与 Sass 生成的一致，否则换肤后无响应
最易忽略的是：主题 map 里别硬编码颜色字符串，比如 "#3b82f6"；要用真实颜色类型（#3b82f6）或已定义变量（$blue-500），否则后续调用 lighten() 或 mix() 会静默失败。
