Less本身不导出多套CSS，构建工具通过多次调用Less编译器并传入不同变量值来生成多份CSS文件；多主题需用Map+each()定义，并基于CSS变量实现运行时切换。
Less 本身不导出多套 CSS，构建工具才决定输出几份
Less 只是一个编译器，它不会“自动导出多套 CSS”。所谓“多套配色方案对应多份 CSS”，本质是构建工具（Webpack/Vite/lessc）调用 Less 编译器多次，每次传入不同的变量值，并指定不同输出路径。你写 @primary-color: #007bff，它永远只产出一份 CSS；要得到 theme-blue.css 和 theme-green.css，就得让构建流程跑两遍。
常见错误现象：
-
lessc --modify-var="primary-color=#2563eb" src/app.less dist/theme-blue.css执行后没生成文件 → 检查路径是否存在、src/app.less是否可读、dist/目录是否可写 - Webpack 中只产出一份 CSS，哪怕配置了多个 entry → 确认
less-loader的modifyVars是否对每个 entry 单独生效（不能写在全局 options 里） - Vite 构建后
theme-dark.css里颜色还是 light 值 →css.preprocessorOptions.less.modifyVars没按build.rollupOptions.input的 key 分别传参
用 Map + each() 定义主题配置，而非嵌套变量
别写 @theme: dark; @primary-color: @dark-primary;——这毫无分支能力，@theme 变量在编译期就被丢弃，@primary-color 永远取 @dark-primary 的值，和 @theme 无关。
真正支持多主题的写法必须用 Less 的 Map 结构和 each()：
立即学习“前端免费学习笔记（深入）”；
@themes: {
blue: { primary-color: #1890ff; bg-color: #ffffff; text-color: #333333; },
green: { primary-color: #52c418; bg-color: #f9f9f9; text-color: #262626; }
};
each(@themes, {
@theme-name: @key;
@theme-vars: @value;
:root[data-theme="@{theme-name}"] {
--primary-color: @theme-vars[primary-color];
--bg-color: @theme-vars[bg-color];
--text-color: @theme-vars[text-color];
}
});
关键点：
- Map 必须用大括号
{}，不能用括号或方括号 - 访问子属性必须用方括号语法
@theme-vars[primary-color]，@theme-vars.primary-color会报错 - 所有组件样式必须基于
var(--primary-color)，不能直接引用 Less 变量，否则 JS 切换主题无效
变量注入必须由构建工具完成，Less 文件里不写环境判断
Less 没有运行时逻辑，if(@env = "prod", #000, #666) 只能选一个值进最终 CSS，无法控制“生成哪份文件”。所有环境区分必须推给构建层。
Webpack 示例（vue.config.js）：
module.exports = {
css: {
loaderOptions: {
less: {
additionalData: `@import "@/styles/variables.less";`,
// 注意：modifyVars 要按 entry 区分，不能放这里
}
}
},
configureWebpack: {
entry: {
'app-blue': './src/main-blue.js',
'app-green': './src/main-green.js'
}
}
// 再配合 less-loader 的 options 根据 entry 名动态返回 modifyVars
Vite 示例（vite.config.ts）：
export default defineConfig({
build: {
rollupOptions: {
input: {
blue: resolve(__dirname, 'src/main-blue.html'),
green: resolve(__dirname, 'src/main-green.html')
}
}
},
css: {
preprocessorOptions: {
less: {
modifyVars: (file) => {
if (file.includes('main-blue')) return { 'primary-color': '#1890ff' };
if (file.includes('main-green')) return { 'primary-color': '#52c418' };
return {};
}
}
}
}
});
容易踩的坑：
-
@import "theme-@{env}.less"—— 完全无效，@{env}在@import路径中不展开，直接报File not found - 在 Less 里用
@primary-color: if(@theme = blue, #1890ff, #52c418)→ 导致所有主题共用同一份 CSS，只是颜色值不同，没解决“多文件”需求 - 忘记给
:root[data-theme="blue"]加!important或覆盖优先级 → 浏览器里切换后颜色不变，其实是被其他样式盖掉了
CSS 变量 fallback 和 IE 兼容需手动兜底
如果你的项目还要支持 IE，var(--primary-color) 会完全失效。这时候必须放弃 CSS 变量方案，改用 Less 输出多份独立 CSS，并靠 JS 切换 <link> 标签。
做法是：
- 构建阶段生成
theme-blue.css和theme-green.css两份静态文件 - 入口 HTML 中预置两个
<link rel="stylesheet" disabled>，用 JS 控制disabled属性 - 组件样式不依赖
var()，而是直接写.button { background: @primary-color; }，但前提是每份 CSS 都是完整编译结果
这个路径下，@primary-color 就不能定义在公共 variables.less 里并靠 !default 覆盖——因为每份 CSS 是独立编译，必须确保 variables.less 中的值已被构建工具通过 modifyVars 锁死，而不是留空靠下游覆盖。
最易被忽略的一点：主题切换后，CSS 变量的继承链和 specificity 很难调试。比如 div .button 里写的 color: var(--text-color);，如果父 div 没设 data-theme，就会回退到 :root 的默认值，而不是就近的 theme-root。这需要你在 DOM 结构上显式传播 data-theme，而不是指望 CSS 自动继承。
