Sublime Text 编译 LESS 依赖系统 lessc 工具，90% 失败源于 PATH 未被 Sublime 正确读取；需确认终端与 Sublime 控制台中均能执行 lessc --version；必须安装 Less（mrh85）插件而非 LESS（dmikalova）；手动配置 Lessc.sublime-build 构建系统并显式指定 path；启用 SublimeOnSaveBuild 实现保存即编译。
Sublime Text 本身不编译 LESS，所谓“安装插件”只是加语法高亮 + 构建触发入口；真正生成 .css 文件必须依赖系统已安装的 lessc 命令行工具，否则 Ctrl+B 或自动监听全部静默失效。
确认 lessc 是否可用且路径被 Sublime 读到
这是 90% 编译失败的根源：你在终端能跑通 lessc --version，不代表 Sublime 启动时环境里有它。
- 终端执行
lessc --version，必须输出类似4.2.0；没输出就先运行npm install -g less - Windows 用户运行
npm config get prefix，把返回路径（如C:UsersYourNameAppDataRoaming pm）加进系统PATH，并重启 Sublime - macOS M1/M2 用户若用 zsh，检查
~/.zshrc是否包含export PATH="$(npm bin -g):$PATH"；否则在构建系统里显式写死path - 验证 Sublime 是否真读到了：按
Ctrl+`打开控制台，执行import os; print(os.environ.get('PATH'))，看输出里有没有lessc所在目录
选对插件：LESS（仅高亮） vs Less（含构建）
别搜“Less 插件”这种模糊词——两个名字接近但功能完全不同，装错就白忙活。
-
LESS（作者 dmikalova）：纯语法高亮，打开.less文件立刻着色，不编译、不监听、不生成.css -
Less（作者 mrh85）：带语法高亮 + 内置lessc构建规则，Ctrl+B 可触发编译，但需手动配path字段 - 别碰
Less2CSS（停更于 2019）、EasyLess（v4.3+ 与lessc@4.3+兼容差，常报TypeError: Cannot read property 'length' of undefined）
配置自定义构建系统让 Ctrl+B 真正生效
插件自带的构建常因路径问题失败，最稳方式是手动建 Lessc.sublime-build 文件，显式指定命令和路径。
立即学习“前端免费学习笔记（深入）”；
- 菜单 → Tools → Build System → New Build System
- 贴入以下内容（注意
path按系统替换）：
{
"cmd": ["lessc", "$file", "$file_path/$file_base.css"],
"path": "/usr/local/bin:/opt/homebrew/bin",
"selector": "source.less",
"shell": true
}
- macOS/Linux：
path填which lessc返回的路径，多个用英文冒号分隔 - Windows：把
path改成"C:\Users\YourName\AppData\Roaming\npm"（双反斜杠），且shell必须为true - 保存为
Packages/User/Lessc.sublime-build，然后右下角状态栏手动选中它
想保存即编译？靠 SublimeOnSaveBuild，不是插件自带监听
Sublime 没有跨平台稳定的文件监听机制，“自动编译”本质是绑定保存动作触发一次构建。插件内置的监听（如 EasyLess 的 Toggle Auto Compile）在 ST4 下兼容性差、报错多，不推荐。
- 用 Package Control 安装
SublimeOnSaveBuild - 菜单 → Preferences → Package Settings → SublimeOnSaveBuild → Settings – User
- 填入：
{
"extensions": ["less"],
"build_on_save": true
}
- 务必删掉默认设置里的其他扩展名（比如
"css"），否则可能误触发 CSS 文件编译报错 - 该方案绕过所有插件监听逻辑，直接调用你刚配好的
Lessc.sublime-build，稳定可控
最容易被忽略的是：Sublime 启动时读取的环境变量和你在终端里看到的不是同一份；哪怕 lessc 装得再全，只要它不在 Sublime 的 PATH 里，一切构建都会静默失败——所以每次配完，务必用控制台 print(os.environ.get('PATH')) 实锤验证。
