Less 4.x 编译报错主因是解析器行为变更：math 默认 strict、@import 更严格、javascriptEnabled 关闭、变量/递归检测变严；需逐项排查并改用原生函数、显式 css 导入、调整 math 配置等。
升级到 Less 4.x 后编译报错，大概率不是语法写错了，而是解析器行为变更触发了旧代码里隐藏的不兼容点：变量循环检测变严格、@import 模式默认行为改变、javascriptEnabled 被禁用、以及 math 计算策略收紧。必须逐项排查，不能只看错误信息表面。
检查 javascriptEnabled 是否被意外启用或禁用
Less 4.x 默认关闭 javascriptEnabled，而很多老项目依赖它执行 @size: unit(10px / 2, px) 这类 JS 表达式。一旦关闭，直接报 ParseError: Unrecognised input 或计算失败。
- Webpack 用户：确认
less-loader的options中未设置javascriptEnabled: true；若必须保留，要加dangerouslyUpdateWebpackConfig提示，且确保构建环境可控 - 命令行用户：运行
npx lessc --javascript-enabled styles.less测试是否恢复——但这是临时绕过，不是解法 - 真正解法：把所有 JS 式计算改用 Less 原生函数，例如用
round(10px / 2)替代unit(10px / 2, px)，并提前用unit()封装好单位转换逻辑
验证 @import 模式是否隐式失效
Less 4.x 对 @import 的默认解析更严格，尤其当路径含中文、通配符或环状依赖时，不再静默容忍，而是直接抛 ParseError 或卡死。
- 报错含
Unrecognised input in .../组件/按钮.less？说明中文路径被 tokenizer 拦截——必须通过less-loader的paths或 Vite 的preprocessorOptions.less.paths配置英文根路径，让@import只看到 ASCII 路径 - 报错定位到
normalize.css第一行？说明它被当 Less 源码解析了——必须显式写成@import (css) "~normalize.css/normalize.css"，且该语句必须在入口文件最顶部 - 多个
@import后样式丢失？检查是否有@import (reference)被误用于需输出 CSS 的文件，(reference)只解析不输出，适合 mixins，不适合 reset
排查变量循环与递归 mixin 的新报错
Less 4.2+ 加入了变量循环检测和最大调用栈限制，以前能跑通的自引用写法（如 @color: darken(@color, 10%)）现在会立刻报 Recursive variable definition。
立即学习“前端免费学习笔记（深入）”；
- 快速验证：新建
test.less，只写@a: darken(@a, 5%)，运行npx lessc test.less—— 若卡住或报内存溢出，就是此问题 - 递归 mixin 必须重写为
.loop()形式：.gen(@n) { .loop(@i) when (@i > 0) { /* 样式 */ .loop((@i - 1)); } .loop(@n); }，旧式.mixin(@n) when (@n > 0) { .mixin((@n - 1)); }已不安全 - 所有带
unit()、percentage()的递归体必须剥离计算，改用预定义常量，否则 AST 求值负担激增，触发新版本的栈深度保护
确认 math 选项是否匹配旧行为
Less 4.x 默认启用 math: 'strict'，而 3.x 是 'always'。这意味着 10px + 5 这种单位与纯数字相加会直接报错，不再自动转换单位。
- Webpack 用户：在
less-loader的options中显式加math: 'always'可临时兼容，但建议逐步改为10px + 5px或calc(10px + 5px) - 命令行用户：加参数
--math=always，例如npx lessc --math=always styles.less - 注意：开启
math: 'always'会弱化类型检查，长期应清理混用单位的表达式，避免在复杂计算中出现隐式转换偏差
最易被忽略的是：错误堆栈里看不到 less 版本提示，但实际报错源头可能藏在某个被 @import 进来的第三方 mixin 库里——升级前务必检查所有依赖是否声明支持 Less 4.x，尤其是 antd、bootstrap-less 这类封装库。
