报 Syntax Error 很可能不是 Less 代码问题，而是 less-loader 与构建工具（如 webpack 5+ 或 Vue CLI）版本不兼容所致；常见原因包括 less-loader 版本过高导致 this.getOptions is not a function 或 loaderContext.getResolve is not a function，以及缺失 less 包；推荐稳定组合为 less@4.2.0 + less-loader@7.3.0。
报 Syntax Error 不一定真是语法写错了，大概率是 less-loader 和当前构建工具（比如 webpack 5+ 或 Vue CLI）不兼容 —— 特别是装了高版本 less-loader（如 8.x、11.x）却没配对对应版本的 less 或构建环境。
less-loader 版本太高导致 this.getOptions is not a function
这是最常见的一类 Syntax Error，实际不是 Less 代码问题，而是 loader 内部调用 Webpack API 失败。Webpack 5 要求 loader 使用 this.getOptions()，但旧版 less-loader（如 4.x–6.x）或某些新版（如 8.x+）在特定环境下会找不到该方法。
- 检查
package.json中less-loader版本：高于 7.x 且项目用的是 Vue CLI 4/5 或 webpack 4/5 混合环境时，极易触发 - 降级推荐组合（经 2026 年实测稳定）：
less@4.2.0+less-loader@7.3.0 - 执行命令：
npm uninstall less-loader --save-dev && npm install less@4.2.0 less-loader@7.3.0 --save-dev - 删掉
node_modules和package-lock.json后重装，避免残留缓存
less-loader 报 loaderContext.getResolve is not a function
这通常出现在 less-loader@8.0.0+ 与 webpack 4 或老版 Vue CLI（如 v4.5.x）搭配时。新 loader 默认依赖 webpack 5 的 loaderContext.getResolve()，而老环境不提供该方法。
- 不要强行升级
less-loader到 8.x 及以上，除非你确认 webpack 是 5.70+ - 若已升级，回退到
less-loader@7.3.0或@6.3.0（后者适配 webpack 4） - 注意：Vue CLI 4 默认 webpack 4，CLI 5 才默认 webpack 5 —— 查
vue --version和webpack --version确认底座
报 Cannot find module 'less' 或 Less implementation “undefined”
错误信息里带 Cannot find module 'less'，说明 less-loader 运行时根本没加载到 less 解析器，不是路径或拼写问题，而是 less 包缺失或版本断裂。
-
less必须作为devDependencies显式安装，不能只靠less-loader间接依赖 - 运行
npm list less，确认它被正确解析（不是empty或UNMET DEPENDENCY） - 避免混用
npm和cnpm安装，尤其在 Windows 下容易漏装二进制依赖 - 如果用 pnpm，需确保
less在项目根node_modules下，而非硬链接子目录中
真正麻烦的不是报错本身，而是错误堆栈里看不到真实 Less 行号 —— 一旦 loader 层崩溃，后续语法校验就全跳过了。所以遇到 Syntax Error，先别急着改样式文件，盯住 less-loader 和 less 的版本配对关系，比一行行查括号更省时间。
