Sublime Text 本身不内置 SASS 编译能力,必须通过插件 + 外部编译器(如 sass CLI 或 dart-sass)协同工作;直接装个插件就“自动编译”是常见误解,多数失败源于路径、版本或配置项没对齐。
确认本地已安装 dart-sass(推荐)
dart-sass 是官方维护的现代 SASS 实现,Node.js 版本的 node-sass 已废弃,Windows/macOS/Linux 均支持。用 npm 安装后,确保终端能调用:
npm install -g sass sass --version
若报 command not found: sass,说明 PATH 未生效——不是插件问题,而是系统找不到命令。解决方式:
- macOS/Linux:检查
~/.npm-global/bin是否在$PATH中 - Windows:重启 Sublime(它不读取新环境变量),或改用绝对路径配置(见下节)
- 避免用
sudo npm install -g sass,权限混乱易导致后续编译失败
安装并配置 Sass Build System(非 Package Control 里的 “Sass” 插件)
Package Control 中搜 “Sass” 插件(作者 mrmlnc)只是语法高亮和快捷键,**不提供编译功能**。真正需要的是自定义 Build System:
立即学习“前端免费学习笔记(深入)”;
- 菜单栏 → Tools → Build System → New Build System…
- 替换全部内容为以下 JSON(注意
cmd中的路径适配):
{
"cmd": ["sass", "--update", "$file:$file_path/$file_base_name.css", "--style=expanded", "--sourcemap=none"],
"selector": "source.sass, source.scss",
"path": "/usr/local/bin" // macOS/Linux 示例;Windows 可写 "C:\\Users\\xxx\\AppData\\Roaming\\npm"
}
关键点: