Sublime Text 编译 Sass 依赖外部 dart-sass CLI，需确认其已正确安装并加入 PATH；构建系统须用 "dart-sass" 命令、正确配置 working_dir 和路径参数，禁用过时的 node-sass 配置。
Sublime Text 本身不编译 Sass，必须靠外部工具链驱动；你看到的“一键编译”，其实是 Sublime 调用 sass 命令或 node-sass（已弃用）/ dart-sass（推荐）执行的。直接在 Sublime 里按 Ctrl+B 跑 Sass，90% 的失败都源于没装对 CLI、路径没配准、或用了过时的构建配置。
怎么确认系统已装 dart-sass 并可用
这是所有后续步骤的前提。Sublime 不管你有没有装，它只负责执行命令——命令报错，就卡住不动。
- 终端运行
dart-sass --version，输出类似1.77.2才算成功；若提示command not found，说明没装或没加进$PATH - 别用
npm install -g sass后以为万事大吉：全局安装的sass包名是sass，但二进制名仍是dart-sass，某些旧版 npm 会软链成sass，但 Sublime 构建系统认的是真实可执行文件名 - Windows 用户特别注意：
sass.bat和dart-sass.bat是两回事；sass包默认生成前者，但官方推荐用后者——优先装dart-sass独立 CLI：choco install dart-sass或手动下载二进制 - Mac/Linux 用户如果用
brew install sass/sass/sass，实际装的是sass命令，但 Sublime 构建里得写"cmd": ["sass", ...]；而 Homebrew Cask 安装的dart-sass则要用"cmd": ["dart-sass", ...]
Build System 怎么写才不报错：路径、输入输出、watch 模式
Sublime 的 Build System 是纯 shell 命令封装，参数顺序、引号、斜杠方向全错一点就失败。别抄网上过时的 node-sass 配置，它早在 2023 年就停止维护。
- 基础编译（单次）：
{ "cmd": ["dart-sass", "$file", "-o", "${file_path}/${file_base_name}.css"], "selector": "source.sass, source.scss", "working_dir": "$file_path" }注意：$file是带扩展名的完整路径，${file_base_name}是无扩展名文件名，别写成$file_name（不存在） - 启用 watch 模式（保存即编译）：
"cmd": ["dart-sass", "--watch", "$file", "-o", "${file_path}/${file_base_name}.css"]；但别指望它“后台运行”——Sublime 的 Build System 是阻塞式执行，一跑--watch就卡死 UI。真要监听，得另开终端跑dart-sass --watch，Sublime 只负责写代码 - 输入是
.sass（缩进语法）还是.scss（CSS-like）？dart-sass默认按扩展名自动识别，不用加--syntax；但如果你混用，强制指定：--syntax=sass或--syntax=scss - 输出 CSS 加 sourcemap？加
--embed-sources --embed-map；但别加--source-map-include-names——dart-sass v1.77+ 已移除该参数，加了直接报错Unknown option
为什么保存后没生成 CSS，或者报错 “Can’t find stylesheet to import”
这几乎全是路径和加载上下文问题。Sass 的 @import 和 @use 不走 Sublime 当前打开的文件路径，而是依赖 dart-sass 启动时的 working_dir 和 --load-path。
-
@import "variables"报错？先看variables.scss在哪：如果它在./src/_variables.scss，而你当前编辑的是./src/main.sass，那没问题；但如果main.sass在./styles/main.sass，而_variables.scss在./src/，就必须加--load-path=../src - Build System 里
"working_dir": "$file_path"是关键——它决定了dart-sass解析相对路径的起点。别设成项目根目录（除非你所有 Sass 文件都在根下），否则@import全挂 - 用了
@use "bootstrap"却找不到？确认你已npm install bootstrap，且在 Build System 中加了--load-path="node_modules"；路径必须是相对于working_dir的，不是绝对路径 - Windows 下路径含空格或中文？
dart-sass对空格敏感，"cmd"数组里每个参数单独字符串，不要拼成一句带空格的字符串，否则解析失败
要不要装 Sass 插件？哪些能信，哪些纯噱头
Sublime 没有官方 Sass 支持，所有插件都是包装 CLI 或做语法高亮。别被“智能编译”“自动 watch”这类宣传误导——它们底层还是调 dart-sass，只是帮你点几下鼠标而已。
- 推荐只装两个：
Syntax Highlighting for Sass（语法高亮，支持 .sass/.scss/.css.erb）、SublimeOnSaveBuild（保存时自动触发 Build System，省得按Ctrl+B） - 慎用
SassBeautify：它依赖 Python 的libsass绑定，而libsass已停更，新版 Sass 功能（如@use规则、模块化）完全不支持，格式化完可能反而报错 - 所谓“实时预览 Sass”的插件，本质是起一个本地服务器把
.sass文件转成 CSS 再注入页面——这和 Live Server 插件干的事重复，还多一层兼容风险；真要热重载，用dart-sass --watch+live-server组合更稳 - 插件设置里如果让你填
sass_binary路径，务必填绝对路径，比如C:/tools/dart-sass/sass.bat；别填sass或dart-sass，Sublime 不查$PATH
最常被忽略的一点：Sass 编译失败时，Sublime 构建面板只显示最后一行错误，比如 Invalid CSS after "...": expected "}", was ";"，但真正出问题的可能是前面第 3 行少了个逗号——得点开完整输出（面板右上角齿轮 → Show Build Results），不然永远在猜。
