Sublime Text 编译 LESS 需同时满足系统存在可用 lessc 可执行文件且插件正确配置其路径,否则保存时静默失败;EasyLess 插件需手动设置 "lessc_path"、启用监听,并规范 @import 路径与中文路径引用。

Sublime Text 本身不带 LESS 编译能力,装插件 ≠ 能编译 —— 必须同时满足「系统级 lessc 可执行文件可用」+「插件能调用它」两个条件,否则保存 .less 文件时静默失败或报错 LESS: Unable to interpret argument clean-css。
确认 lessc 是否真正可用
很多问题根源不在 Sublime,而在终端里 lessc --version 能运行 ≠ Sublime 能调用。Sublime 启动时不会自动加载你 Shell 中的 $PATH,尤其在 macOS 或 Linux 图形界面下启动时更常见。
- 在终端中运行
which lessc,记下完整路径(例如/usr/local/bin/lessc) - 打开 Sublime 的插件设置(
Preferences > Package Settings > EasyLess > Settings),添加字段:"lessc_path": "/usr/local/bin/lessc"
- Windows 用户若用 PowerShell 能运行
lessc,但 Sublime 仍报错,尝试把%APPDATA%\npm加入系统环境变量,并重启 Sublime(不是重载窗口) - 避免用
npm install less@1.6.2 -g这类降级方案 —— 旧版lessc不支持现代嵌套语法,且与clean-css插件冲突概率高
别用 Less2CSS,选 EasyLess
Less2CSS 自 2017 年起停止维护,Sublime Text 4 下基本不可用;它对 @import 相对路径解析错误率高,且无法正确处理中文路径中的空格和编码。
-
EasyLess支持 source map、自定义输出目录、监听子目录变更,配置项清晰(如"output_dir"、"auto_compile_on_save") - 安装后右键
.less文件 →EasyLess: Toggle Watch才真正启用监听,不是保存就自动触发 - 若项目结构是
src/styles/main.less→ 希望输出到dist/css/main.css,需在 EasyLess 设置中显式写:"output_dir": "dist/css"
,而不是依赖相对路径推断
@import 路径和中文路径容易炸
LESS 编译器解析 @import 时默认以入口文件所在目录为基准,但 EasyLess 默认工作目录是 Sublime 当前打开的文件夹根目录 —— 两者不一致就会报 File not found。
- 所有
@import路径建议统一用相对路径(如@import "./variables.less";),避免@import "mixins"这种无扩展名写法(lessc4.x+ 已弃用) - 含中文或空格的路径必须用双引号包裹:
@import "基础变量.less";,否则编译直接中断 - 如果
main.less里@import "../lib/reset.less"报错,先确认 Sublime 当前项目是否以main.less所在父目录为根(右键文件夹 →Add Folder to Project)
最容易被忽略的是:Sublime 的插件进程不继承你的 Shell 配置,所以即使 lessc --version 在终端里跑得飞起,插件也可能完全找不到它。硬编码 lessc_path 是最稳的解法,别指望“重启几次就好了”。


















