Sublime Text 本身不编译 Sass，所谓“SassBuild”实为Dart Sass CLI + 自定义构建系统；90%失败源于sass命令在Sublime内不可见，需用which/where查绝对路径并配置sass_path或改用SublimeOnSaveBuild+自定义.sublime-build。
Sublime Text 本身不编译 Sass，所谓“SassBuild 工具”不是独立软件，而是指用 Dart Sass CLI + 自定义构建系统（Build System）实现的编译流程。配置失败的绝大多数情况，根源是 sass 命令在 Sublime 内部不可见，而不是插件没装对或设置点错了。
确认 sass 命令是否真能在 Sublime 里调用
终端里能跑 sass --version ≠ Sublime 能调用它。macOS/Linux 图形界面启动 Sublime 时完全不继承 shell 的 PATH；Windows 上若用了 nvm，当前 Node 版本下没全局装 sass，也会报 command not found。
- 先在终端执行
which sass（macOS/Linux）或where sass（Windows），拿到绝对路径，例如/opt/homebrew/bin/sass或C:\Users\Me\AppData\Roaming\npm\sass.cmd - 打开
Preferences → Package Settings → Sass → Settings（注意：是原生 Sass 插件的设置，不是 SCSS 插件） - 在右侧用户设置中写入：
"sass_path": "/opt/homebrew/bin/sass"（只填路径，不带参数） - 重启 Sublime，再试保存 .scss 文件——如果仍没反应，说明插件根本没走这条路径，得换方案
用 SublimeOnSaveBuild + 自定义 .sublime-build 最稳
原生 Sass 插件对 @use、@forward 支持差，报错像 Error: Invalid CSS after "@use" 就是它在罢工。而 SublimeOnSaveBuild 只负责监听保存动作，把任务干净交给系统级 sass，兼容性好、错误可读性强。
- 用 Package Control 安装
SublimeOnSaveBuild - 菜单栏
Tools → Build System → New Build System…，粘贴以下内容：
{
"cmd": ["sass", "--no-source-map", "$file", "${file_path}/${file_base_name}.css"],
"selector": "source.scss, source.sass",
"file_regex": "^(.*?):([0-9]+):([0-9]+) (.*)$"
}
- 保存为
Sass.sublime-build（必须放在Packages/User/下） -
--no-source-map必须加，否则构建常卡住；需要 sourcemap 时换成--embed-sources -
file_regex必须匹配 Dart Sass 报错格式，否则错误被吞掉，控制台只显示 “build finished”，你连哪行错了都不知道
路径含中文或空格会导致编译静默失败
Dart Sass 在 Windows 下对非 ASCII 路径极其敏感，常见现象是保存后无任何输出、无报错、CSS 文件也不生成，控制台也空空如也。这不是配置问题，是底层限制。
- 把项目移到纯英文路径下，例如
C:/project/myapp或/Users/me/project - 检查
$file变量展开后是否含中文或空格：在构建系统里临时改成"cmd": ["echo", "$file"]，看输出 - Sublime 的
console（Ctrl+`）里如果出现类似Error: Invalid CSS after ""，基本就是路径惹的祸
为什么改了 _variables.scss 但主文件编译报 undefined variable
这不是构建系统的问题，是 Sass 解析器根本没加载那个文件。Sublime 插件默认只编译当前打开的文件，不会自动 resolve @import 或 @use 的路径依赖。
- 确保主文件（如
main.scss）开头有明确引用：@use "variables";或@import "variables"; - 被引用的
_variables.scss必须和主文件在同一目录，或在sass命令的--load-path指定目录中 - 自定义构建系统里不能直接加
--load-path，需改"cmd"为：["sass", "--load-path=src/scss", "$file", "${file_path}/${file_base_name}.css"]
真正卡住人的地方，往往不是语法或路径写错，而是 Sublime 启动时根本看不到你精心配好的 sass，或者 Dart Sass 在非标准路径下直接放弃报错。验证这一步，比调十次构建系统都管用。
