Sublime Text 本身不编译 Less，需依赖系统已安装的 lessc 命令行工具；插件仅提供语法高亮与调用入口，真正编译由 Node.js 环境中的 lessc 完成，PATH 配置、lessc 可用性及版本兼容性是关键。
Sublime Text 本身不编译 Less，所谓“配置 Less 转 CSS”本质是让 Sublime 调用系统已安装的 lessc 命令行工具——插件只负责语法高亮和触发命令，真正干活的是你本地的 Node.js 环境。装错插件、漏装 lessc、PATH 没被 Sublime 读到，这三处任一出问题，Ctrl+B 或自动保存都不会生成 .css 文件。
确认 lessc 是否可用且路径正确
这是最常卡住的环节：Sublime 启动时读取的是它自己的环境变量，不是你在终端里能跑通 lessc --version 就代表 Sublime 也能调用。
- 在终端（CMD/PowerShell/Terminal）中运行
lessc --version，必须有输出（如4.2.0），否则先执行npm install -g less - Windows 用户注意：
npm config get prefix查出全局 bin 路径（通常是C:\Users\YourName\AppData\Roaming\npm），这个路径必须加进系统PATH，且 Sublime 需重启才能加载新 PATH - macOS/Linux 用户若用 zsh 或 fish，确保
lessc在$PATH中，可临时在 Sublime 构建系统里显式写死path字段（如/opt/homebrew/bin:/usr/local/bin） - 如果 Sublime 控制台（
Ctrl+`）报'lessc' is not recognized或command not found，基本就是这一步没过
选 EasyLess 而不是 Less2Css
Less2Css 插件自 2019 年后无更新，不兼容 Sublime Text 4，对嵌套规则、@import 相对路径解析错误频发；EasyLess 是当前唯一持续维护、支持自动监听和 source map 的 Less 插件。
- 通过
Ctrl+Shift+P→Package Control: Install Package搜索并安装EasyLess - 安装后无需重启，右键任意
.less文件 →EasyLess: Toggle Auto Compile开启监听 - 默认输出同目录同名
.css，如需改到css/子目录，在Preferences → Package Settings → EasyLess → Settings – User中添加：{ "output_dir": "css" } - 若编译失败，看 Sublime 控制台真实报错：常见如
File not found: _mixins.less，说明@import "_mixins"的路径是相对于当前文件，不是项目根目录——别用/开头的绝对路径
用命令行 lessc --watch 更稳
依赖插件自动编译容易受 Sublime 启动方式、FTP 插件、保存策略干扰；直接在终端运行 lessc --watch 是最轻量、最可靠的方式，尤其适合单文件调试或小项目。
立即学习“前端免费学习笔记（深入）”；
- 进项目根目录，运行：
lessc --watch src/styles.less dist/styles.css
- 支持目录监听（v4.0+）：
lessc --watch src/:dist/
，自动把src/a.less编译为dist/a.css - 加
--source-map生成映射文件：lessc --watch --source-map src/styles.less dist/styles.css
- 这个过程独立于 Sublime，只要终端开着，保存
.less就实时更新.css，连 Ctrl+B 都不用按
中文路径和 lessc 版本兼容性要当心
Windows 下中文路径极易导致 lessc 解析失败或输出乱码，而新版 lessc@4.3+ 又与部分插件存在 API 不兼容。
- 项目路径、文件名尽量用纯英文，避开空格和中文——这不是矫情，是实测高频失败点
- 如果
EasyLess报TypeError: Cannot read property 'length' of undefined，大概率是lessc太新，临时降级：npm install -g less@4.1.3
- 不推荐用
less-plugin-clean-css：Dart Sass 已成主流，Less 生态也转向更轻量的压缩方式；如需压缩，用lessc --clean-css（需额外装）或交给构建工具处理
真正难的不是装几个插件，而是让 Sublime 和你的 shell 环境达成一致——lessc 在哪、能不能被找到、路径是否含中文、版本是否匹配，这些细节错一个，整个链路就静默失效。建议先跑通命令行 lessc --watch，再回头配插件，省掉一半排查时间。
