Sublime Text 本身不编译 Sass，所谓“自动编译”仅调用系统已安装的 Dart Sass 命令；90% 失败源于环境变量不一致或 sass 路径未正确配置，需通过 which/where 获取绝对路径、重启 Sublime 并配合 SublimeOnSaveBuild + 自定义 .sublime-build 实现稳定编译。
Sublime Text 本身不编译 Sass，所谓“安装 Sass 环境”其实是让 Sublime 能调用你系统里已装好的 sass 命令——没装对、路径不对、或 Sublime 启动时压根找不到它，保存就静默失败，连错误都不报。
确认 sass 命令是否真被 Sublime 看得见
终端里 sass --version 有输出，不代表 Sublime 就能用。macOS/Linux 图形界面下 Sublime 不读 ~/.zshrc；Windows 上 npm 全局路径常没进系统 PATH，或用了 nvm 切换 Node 版本后失效。
- 新开一个终端（不是 Sublime 自带 console），运行
which sass（macOS/Linux）或where sass（Windows），拿到绝对路径，比如/opt/homebrew/bin/sass或C:\Users\Alice\AppData\Roaming\npm\sass.cmd - 关掉 Sublime，从 Dock / 开始菜单重新启动它，再测试
- macOS 若用 Homebrew 安装 Dart Sass，检查
~/.homebrew/bin是否在$PATH；Windows 若用nvm，确保当前 Node 版本下已全局安装：nvm use 20 && npm install -g sass
别用 LiveSassCompiler 插件——它会吞掉 @use 错误
LiveSassCompiler 看似一键启用，但实际封装太深：遇到 @use 语法直接报 Invalid CSS after "@use" 却不显示具体哪行、哪个文件出错；中文路径、空格路径下也容易卡死；错误常被静默吞掉，排查无从下手。
- 名字叫 SCSS（作者 mrmartineau）的插件也自带轻量编译器，同样不支持
@use，且输出路径固定，无法映射嵌套结构 - 推荐绕过这类插件，改用
SublimeOnSaveBuild+ 自定义构建系统，报错可见、路径可控、@use/@forward全支持
用 SublimeOnSaveBuild + 自定义 .sublime-build 实现稳定编译
这是目前最可控的组合，不依赖插件内置逻辑，完全走标准 CLI 流程。
立即学习“前端免费学习笔记（深入）”；
- 先装插件：
Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜索并安装SublimeOnSaveBuild - 新建构建系统：
Tools → Build System → New Build System…，粘贴以下内容并保存为Sass.sublime-build（放在Packages/User/目录下）：
{
"cmd": ["sass", "--no-source-map", "$file", "${file_path}/${file_base_name}.css"],
"selector": "source.scss, source.sass",
"file_regex": "^(*?):([0-9]+):([0-9]+)"
}
-
--no-source-map必须加，否则构建可能卡住；如需 sourcemap，改用--sourcemap=inline -
${file_path}/${file_base_name}.css是动态路径，避免多文件互相覆盖；别写死成style.css -
selector必须是source.scss, source.sass，否则保存时不会触发
想按项目结构输出 CSS？别信 output_dir 配置
原生 Sass 插件的 output_dir 只支持扁平化输出（所有 CSS 都扔进一个目录），不保留源文件嵌套结构。要实现 src/scss/main.scss → dist/css/main.css 或更深层级映射，必须自己写构建命令。
- 例如映射到
dist/css/同级目录："cmd": ["sass", "$file", "${file_path}/../dist/css/${file_base_name}.css"] - 若源文件在
src/scss/components/button.scss，想输出到dist/css/components/button.css，就得用 shell 脚本或 Node 工具做路径替换——Sublime 构建系统本身不支持自动层级映射 - 项目路径含中文、空格或括号时，
sassCLI 会静默失败，务必提前清理
真正麻烦的从来不是“怎么配”，而是 Sublime 启动时环境变量和你终端看到的不一致——这个点最容易被忽略，也是 90% 编译失败的根源。
