Sublime Text 本身不编译 Sass，所谓“自动编译”全靠外部 sass 命令 + 插件触发实现；没装好 Dart Sass 或 PATH 没通，再配十遍构建系统也没用。确认 sass 命令是否真可用是 90% 编译失败的根源，Sublime 启动时读的是自己的环境变量，不是终端里能跑 sass --version 就算完事。
Sublime Text 本身不编译 Sass，所谓“自动编译”全是靠外部 sass 命令 + 插件触发实现的；没装好 Dart Sass 或 PATH 没通，再配十遍构建系统也没用。
确认 sass 命令是否真可用
这是 90% 编译失败的根源。Sublime 启动时读的是自己的环境变量，不是你终端里能跑 sass --version 就算完事。
- 在终端（CMD/PowerShell/Terminal）中执行
sass --version，必须输出类似1.77.6的版本号；没反应？说明没装或没进 PATH - Windows 用户：运行
npm config get prefix，把返回路径（如C:\Users\XXX\AppData\Roaming\npm）加进系统环境变量PATH，然后重启 Sublime - macOS 用户：用
which sass查路径，常见是/opt/homebrew/bin/sass或/usr/local/bin/sass；如果用zsh，确保PATH在~/.zshrc里生效，且 Sublime 是从终端启动（subl .），否则它看不到 shell 的 PATH - 别用
node-sass或 Ruby Sass：已废弃，不支持@use，报错会卡在Invalid CSS after "@use"
选对插件：别装错成语法高亮包
搜 “Sass” 容易装错。真正干活的不是 Sass（只管着色），而是 SCSS、Easy SCSS 或配合 SublimeOnSaveBuild 的自定义构建系统。
-
SCSS插件（作者 mrmartineau）：依赖系统sass命令，配置灵活但错误提示弱；保存失败时控制台可能没输出，得手动打开 Sublime 控制台（Ctrl+`）看报错 -
Easy SCSS：自带轻量编译器，不用装sassCLI，但不支持@use、@forward，适合小项目快速验证 -
SublimeOnSaveBuild+ 自定义.sublime-build：最可控，推荐用于正式项目；装完插件后，Tools → Build System → New Build System…贴入配置，保存为Sass.sublime-build - 别碰多年未更新的老插件（如 SassBuild）：Sublime Text 4 下大概率不兼容，右下角状态栏点不动、保存无响应
构建系统关键参数不能写错
一份能跑的 Sass.sublime-build 必须匹配 Dart Sass 的输入输出逻辑和报错格式，否则静默失败或路径错乱。
-
"cmd"或"shell_cmd"要带全路径或确保path字段正确：例如 macOS 上加"path": "/opt/homebrew/bin:/usr/local/bin"，Windows 上填 npm bin 目录 - 输出路径别硬编码：
"${file_path}/${file_base_name}.css"是安全写法；写成"./css/style.css"会导致多文件互相覆盖 -
"file_regex"必须匹配 Dart Sass 报错格式："^(.*?):([0-9]+):([0-9]+) (.*)$"；Ruby Sass 格式不同，混用会导致错误被吞掉 - 加
--no-source-map避免构建卡住；需要 source map 就用--source-map=inline或--source-map，别用默认行为 -
"selector": "source.scss, source.sass"必须存在，否则保存.scss文件时根本不会触发构建
编译无声失败？先看控制台和文件状态
很多问题表面是“没反应”，实际是路径、语法或权限卡在底层，插件根本不报错。
- 按
Ctrl+`打开 Sublime 控制台，保存.scss文件，看有没有exec: ...日志或error行；没日志？说明构建系统根本没被调用 - 检查右下角状态栏：显示 “SCSS” 才代表语法识别成功；显示 “Plain Text” 或 “CSS” 就算配了构建也白搭
- 临时文件无法编译：未保存的
Untitled标签页按保存，$file变量为空，sass会报File to read not found - 路径含中文或空格：Dart Sass 对空格敏感，
sass "a b.scss" "a b.css"必须加引号；建议整个项目路径用英文、无空格 -
@import "reset"报错？Dart Sass 不再隐式补.scss，必须写成@import "reset.scss"或改用@use
最容易被忽略的是：Sublime 启动时的环境变量和终端不一致，以及构建系统没绑定到文件类型——这两点不解决，后面所有配置都是空中楼阁。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
