报syntax error大概率是less-loader与构建环境不兼容或less包缺失，而非.less语法错误；需检查less-loader版本是否匹配webpack/vue cli、less是否显式安装为devdependencies，并清理node_modules重装。
报 Syntax Error 却找不到具体是哪个 .less 文件出问题，大概率不是代码写错了，而是构建链路里 less-loader 和环境不兼容——错误堆栈根本没走到 Less 解析器，卡在 loader 初始化阶段就崩了。
less-loader 版本错配导致“假语法错误”
Webpack 5 或 Vue CLI 5 下装了 less-loader@8.0.0+，常见报错是 this.getOptions is not a function 或 loaderContext.getResolve is not a function。这不是你的 .less 有错，是 loader 拿不到 Webpack 提供的 API。
- 查当前版本：
npm list less-loader，若高于7.3.0且项目用的是 Vue CLI 4 / Webpack 4，基本就是它 - 降级命令：
npm uninstall less-loader --save-dev && npm install less@4.2.0 less-loader@7.3.0 --save-dev - 删掉
node_modules和package-lock.json后重装，避免残留旧版 resolve 逻辑
less 包缺失或未正确加载
报 Cannot find module 'less' 或 Less implementation "undefined"，说明 less-loader 根本没拿到解析器实例。它不会尝试编译你的文件，直接退出并伪造一个“语法错误”提示。
- 运行
npm list less，确认输出里有明确版本（不是empty或UNMET DEPENDENCY） -
less必须显式安装为devDependencies，不能只靠less-loader的间接依赖 - pnpm 用户注意：
less必须出现在项目根node_modules下，不能被硬链接到子目录
CI 或脚本中漏掉 --js 参数
本地开发可能正常，CI 报错却指向奇怪行号？lessc 在无参数下默认禁用 JS 支持，遇到 @import "~antd/less" 或 unit() 这类调用，会静默中断并留下未替换的变量占位符（如 @primary-color），浏览器解析时才报“CSS parsing error”，但源头在 .less 编译阶段已失效。
- CI 脚本中必须显式加
--js：lessc --js --include-path=src/less src/less/main.less dist/css/main.css -
--include-path不能写相对路径（如./src/less），CI 工作目录不确定，要用绝对或项目内固定路径 - 所有
@import路径必须纯 ASCII，含中文、空格或 emoji 的路径会导致解析器提前退出，不报具体位置
真正难定位的不是错误本身，而是错误发生时你看到的行号和文件名，往往来自构建工具包装层，而非 Less 真实解析位置——先验性排除 less-loader 和 less 的版本与安装状态，比一行行翻 .less 文件快得多。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
