sublime text 编译 less 必须配置 lessc 环境变量并选用稳定插件less（mrh85），因插件不自动解析 @import、output_dir 相对于项目根目录，且环境变量与终端隔离。
Sublime Text 本身不编译 Less，所谓“现代化样式编译”必须依赖外部 lessc 命令或插件内置引擎——但后者仅支持基础语法，遇到 @import、@plugin 或模块系统就直接 fallback 失败。真要稳定跑起来，得先让 lessc 在 Sublime 里能被看见。
确认 lessc 是否真被 Sublime 读到
终端里 lessc --version 能输出 4.2.0，不代表 Sublime 就能调用它。Sublime 启动时加载的是自己的环境变量，和终端完全隔离。
- Windows 用户：运行
where lessc，把返回路径（比如C:\Users\Me\AppData\Roaming\npm\lessc.cmd）加进系统 PATH，然后彻底关闭并重启 Sublime - macOS/Linux 用户：在终端执行
which lessc，若返回空或路径不在/usr/local/bin或/opt/homebrew/bin，说明 shell 配置没生效；可临时在构建系统里硬写"path": "/opt/homebrew/bin:/usr/local/bin" - 打开 Sublime 控制台（
Ctrl+`），保存一个.less文件，如果看到'lessc' is not recognized或spawn lessc ENOENT，就是路径没对上
选哪个插件？别踩 EasyLess 和 Less2CSS 的坑
Less2CSS 声称“纯 Python、不用 Node”，但它在 2026 年已停止维护，对 @import "base/variables" 这类路径解析错误频发；EasyLess 则与 less@4.2.0+ 兼容差，常报 TypeError: Cannot read property 'length' of undefined。
- 当前唯一实测稳定的插件是
Less（作者 mrh85），支持 ST4，含语法高亮 + 内置构建规则 - 安装后右键
.less文件 →Set Build System→ 必须手动选中Less，否则Ctrl+B会走默认构建系统 - 它不支持自动监听子文件：改了
mixins.less，但没重存style.less，CSS 就不会更新
output_dir 是相对项目根目录，不是 .less 文件所在目录
很多人填 "output_dir": "css"，结果 CSS 被生成到 Sublime 窗口顶部显示的项目文件夹外层，甚至覆盖其他项目的文件。
-
output_dir是相对于File → Open Folder打开的那个根目录，不是当前文件路径 - 想把
src/less/main.less编译成dist/css/main.css，就得设"output_dir": "dist/css"，且确保该目录存在 - Less 插件本身对嵌套路径映射支持弱，不建议依赖它做复杂结构输出；如需保留目录层级，退回到命令行用
lessc --watch src/less/main.less dist/css/main.css更可靠
为什么变量报错 “ReferenceError: variable @primary-color is not defined”
这不是你变量写错了，而是编译器根本没加载 @import 的文件——因为 Less 插件默认只处理当前激活 tab 的内容，不递归解析依赖链。
- 检查右下角状态栏是否显示
Less: watching，没显示说明监听压根没启 - 确认用户配置里开了
"auto_compile": true，而不是只靠Ctrl+B手动触发 - 留意文件顶部是否有
// @compile false或/* @no-compile */注释，某些旧版插件仍会识别并跳过 - 真正可靠的方案：放弃插件监听，用终端跑
lessc --watch --include-path=src/less src/less/main.less dist/css/main.css，它才真正 resolve 所有@import
最麻烦的从来不是装插件，而是 Sublime 的环境变量加载时机、插件对 @import 的解析粒度、以及 output_dir 的相对基准——这三处稍一错位，就只剩静默失败。
