Sublime Text 的 Sass 编译依赖系统已安装的 Dart Sass，90% 失败源于环境变量不一致或未正确配置 sass 可执行路径；需在终端验证 sass --version 和 which sass，并在插件设置中指定完整路径，重启 Sublime 后生效。
Sublime Text 本身不编译 Sass，所谓“自动编译”只是调用你系统里装好的 sass 命令；没装、路径不对、或 Sublime 启动时根本找不到它，保存就静默失败——连错误都不报。
确认 sass 命令真正在终端可用
这是 90% 编译失败的根源。Sublime 启动时读的是自己的环境变量，不是你终端里能跑 sass --version 就算完事。
- 在终端执行
sass --version，必须输出类似1.77.6的版本号；没反应？说明没装或 PATH 没生效 - macOS 用户运行
which sass查真实路径（常见是/opt/homebrew/bin/sass或/usr/local/bin/sass） - Windows 用户运行
npm config get prefix，再拼上sass.cmd（如C:\Users\Alice\AppData\Roaming\npm\sass.cmd） - 别用
node-sass—— 它已停更，Dart Sass是唯一维护中的官方实现
配置插件识别 sass 可执行文件路径
Sublime 默认不继承 shell 的 PATH，尤其 macOS/Linux 图形界面下，或 Windows 上用了 nvm 切换 Node 版本后。
- 打开
Preferences → Package Settings → Sass → Settings（注意不是 LiveSassCompiler，是原生 Sass 插件） - 在右侧用户设置中填入：
"sass_path": "/opt/homebrew/bin/sass"（只填可执行文件路径，不是sass --watch） - Windows 用户若用 nvm，请确保当前 nvm 使用的 Node 版本下已全局安装：
nvm use 20 && npm install -g sass - 改完保存，重启 Sublime（不是重载，是彻底退出再启动）
用自定义构建系统控制输出路径和格式
原生 Sass 插件的 output_dir 只支持扁平化输出（所有 CSS 都扔进一个目录），不保留源文件嵌套结构。要映射 src/scss/main.scss → dist/css/main.css，必须换方案。
- 菜单栏：Tools → Build System → New Build System…
- 粘贴以下内容（注意
shell: true和working_dir）：{ "cmd": ["sass", "$file", "${file_path}/../dist/css/${file_base_name}.css"], "selector": "source.scss", "shell": true, "working_dir": "$file_path" } - 保存为
Sass-dist.sublime-build，放在Packages/User/目录下 - 打开 .scss 文件，选中该构建系统，按
Ctrl+B（Windows）或Cmd+B（Mac）触发编译 - 如需压缩输出，把
"sass"改成"sass", "--style=compressed"
LiveSassCompiler 插件对嵌套路径的支持更直接
如果你不想写 JSON 构建系统，又需要保留目录结构（比如 src/scss/components/_button.scss 被 main.scss 引入后，CSS 输出到 dist/css/components/main.css），LiveSassCompiler 是更省事的选择。
- 安装插件后，打开一个 .scss 文件，右下角点
Live Sass: Watch Sass或按Ctrl+Alt+C - 进入
Preferences → Package Settings → LiveSassCompiler → Settings - 在用户设置中加：
"live_sass_compiler.settings.formats": [ { "format": "expanded", "extension": ".css", "saveTo": "dist/css/" } ], "live_sass_compiler.settings.save_generated_files": true - 它会自动按源文件相对路径生成对应层级的 CSS，但注意：它不支持
@use的模块解析调试，出错时控制台信息不如 CLI 直观
最常被忽略的点是：Sublime 启动时的环境变量和终端不一致，导致路径配置看似正确却无效；另一个是误用已停更的 node-sass，遇到 Node 20+ 就直接报错。动手前先在终端确认 sass --version 和 which sass，比反复调插件设置更省时间。
