Less无法运行时切换主题，必须通过预编译多套CSS并结合CSS自定义属性（--xxx）兜底，由JS或媒体查询动态控制变量值，所有样式需统一使用var(--xxx)引用才能实现真正响应式深色模式。
Less 本身不支持运行时主题切换，所谓“快速构建适配深色模式的主题包”，本质是用 Less 管理变量 + 预编译多套 CSS + 用 CSS 变量兜底运行时响应。硬靠 Less 单独实现深色模式切换，一定会在 JS 切换、媒体查询联动或第三方组件兼容上翻车。
为什么不能只靠 Less 编译出两套 CSS 就完事
很多人以为：写个 light.less 和 dark.less，分别 @import 不同变量，再用 Webpack 打出两个 CSS 文件，JS 切 <link> 就行——这确实能跑，但会立刻撞上三个硬伤：
- 无法响应系统级偏好（
prefers-color-scheme: dark），用户开了系统深色，页面还是亮的 - 第三方 UI 库（如 Ant Design、Element Plus）样式不会跟着变，除非你把它们的 Less 源码也全拉进来重编译
- 局部禁用深色（比如某个卡片固定浅色）得靠额外 class + 大量覆盖规则，维护成本爆炸
真正可持续的做法，是让 Less 只干一件事：生成并同步 CSS 自定义属性，把切换逻辑交给浏览器和 JS。
用 Less 定义主题源，但必须导出为 :root 下的 CSS 变量
别在 Less 里直接写 .card { background: @bg-color; }——那只是静态值，换主题时毫无反应。正确路径是：
立即学习“前端免费学习笔记（深入）”；
- 在
variables.less里定义原始值：@bg-color-light: #f9fafb;、@bg-color-dark: #111827; - 显式声明
:root变量块，把关键值挂上去：:root { --bg-color: @bg-color-light; --text-color: @text-color-light; } - 用
@media (prefers-color-scheme: dark)覆盖同一组变量，不是重写选择器：@media (prefers-color-scheme: dark) { :root { --bg-color: @bg-color-dark; --text-color: @text-color-dark; } } - 所有组件样式必须用
var(--bg-color)，而不是@bg-color-light
这样，系统切换自动生效；JS 也能用 document.documentElement.classList.add('dark') 手动触发，且不破坏媒体查询逻辑。
Less 中颜色函数（如 lighten()、mix()）怎么安全用于深色主题
Less 的颜色函数只能在编译期计算，不能拿 var(--primary) 当参数——它会报 Operation on an invalid type。所以必须分层处理：
- 主色用 HSL 拆解：
@primary-h: 200;、@primary-s: 85%;、@primary-l: 60%;，方便统一调明度适配深色 - 衍生色在 Less 里算好再赋给 CSS 变量：
@primary-dark: hsl(@primary-h, @primary-s, 30%);→--primary-color-dark: @primary-dark; - 避免嵌套调用：
mix(spin(lighten(@c, 10%), 30%), @c, 50%)难调试，拆成中间变量更可控 - 如果要用
fade()或contrast()等函数，必须确保传入的是编译期确定的颜色值（如#007bff），不是var(--xxx)
记住：Less 函数输出的是固定值，CSS 变量才是运行时桥梁。混用二者（比如 background: lighten(var(--bg), 10%)）在任何浏览器都不合法。
如何让 JS 主动切换主题时，不和 prefers-color-scheme 冲突
用户点按钮切主题，不是要废掉系统偏好，而是“覆盖”它。关键在于优先级控制：
- HTML 上加
data-theme="dark"，不要直接改:root的 style 属性 - CSS 中写：
html[data-theme="dark"] :root { --bg-color: #111827; --text-color: #f9fafb; } - 这条规则必须放在
@media (prefers-color-scheme: dark)块之后，或加!important（仅限必要变量） - 切换后记得存到
localStorage，并在初始化时读取，否则刷新就回退到系统设置
最容易被忽略的一点：深色模式下，原生表单控件（<input>、<select>）可能还是亮的。必须在 :root 加 color-scheme: light dark;，浏览器才肯按 CSS 变量渲染它们。
