less-loader v6+ 要求 modifyvars 必须置于 lessoptions 对象内，且需配置 javascriptenabled: true；webpack 5 下需 less ≥ 4.0、css-loader@6+ 与 postcss-loader 正确排序，避免 loader 链断裂或版本混装。
less-loader 升级后 modifyVars 报错：options has an unknown property
这是新旧版本配置结构不兼容的典型表现。v6+ 的 less-loader 不再接受顶层 modifyVars，必须收进 lessOptions 对象里，否则直接抛 ValidationError。
- 错误写法（v5 及以前）：
modifyVars: { 'primary-color': '#1890ff' } - 正确写法（v6+）：
lessOptions: { javascriptEnabled: true, modifyVars: { 'primary-color': '#1890ff' } } - 漏掉
javascriptEnabled: true会导致 Ant Design 等库的某些函数（如color()、fade()）解析失败 - 如果用的是 Webpack 5 +
less-loader@11，还要确认less本身版本 ≥ 4.0，否则lessOptions里的选项可能被忽略
Webpack 构建报 No module factory available for CssDependency
这通常不是 less-loader 单独的问题，而是 loader 链断裂导致 CSS 依赖无法识别。升级后最容易出问题的是 css-loader 和 style-loader 的顺序或版本错配。
-
style-loader必须在css-loader之前（数组靠前），否则 Webpack 找不到处理CssDependency的工厂 -
css-loader@6+与 Webpack 5 兼容，但和less-loader@11搭配时，importLoaders值要设为2或3（因为链上还有postcss-loader） - 如果用了
MiniCssExtractPlugin.loader，确保它只在 production 下启用，且不能和style-loader同时出现在一个 rule 的use数组中 - 检查
node_modules里是否混装了多个css-loader版本（比如子依赖带了 v3），可用npx npm-check-updates -u统一升级再重装
Ant Design 样式不生效或变量未覆盖
升级后常见现象是 @import '~antd/lib/style/index.less' 编译成功，但主题色没变——本质是 less-loader 没把 modifyVars 传给 Less 引擎，或传早了。
- 确保
lessOptions.modifyVars是对象字面量，不要用变量引用（如modifyVars: themeVars），否则 Webpack 热更新时可能读不到变化 - 如果项目用
customize-cra或react-app-rewired，别用addLessLoader()，它内部封装可能没适配新 API；改用addWebpackModuleRule()手动写 rule - Ant Design v5 要求
less≥ 4.1.3，低于此版本会静默忽略modifyVars，可通过npm ls less确认实际安装版本 - 开发环境开启 sourceMap 时，
lessOptions里必须显式写sourceMap: true，否则变量注入可能发生在 sourcemap 生成之后，导致调试时样式定位错乱
postcss-loader 在 less 之后失效，autoprefixer 不加前缀
Autoprefixer 生效的前提是它接收到的是标准 CSS 字符串，而不是 Less AST。如果 postcss-loader 插在 less-loader 前面，它根本收不到编译后的 CSS，自然不会加前缀。
- loader 执行顺序必须是：
style-loader→css-loader→postcss-loader→less-loader - 注意：这是从右往左执行，所以配置数组里
less-loader要放在最后，postcss-loader紧挨着它前面 -
postcss-loader的postcssOptions.plugins必须显式声明autoprefixer，不能只靠browserslist配置自动启用 - 如果项目有
.browserslistrc，确认里面没有过时语法（如dead），browserslist@4.24+才完全支持该关键字
最易被忽略的一点：less-loader 升级后，lessOptions 里的任何字段都必须是 JSON 可序列化的值。函数、正则、undefined 都会被丢弃——比如你以为写了 math: 2 就能启用严格数学模式，但如果 less 库版本不够，这个字段就等于没写。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
