Sublime Text 中 Sass-Autocompile 插件无法调用 sass 命令是因未继承系统 PATH，需手动配置绝对路径；它不追踪 import 依赖链，需激活主入口文件；不支持源目录结构映射和多版本并发，应改用项目级构建系统或替代插件。
Sublime Text 找不到 sass 命令，报 “command not found”
这不是插件问题，是 Sublime 启动时根本没继承 shell 的 PATH。你在终端能跑 sass --version，不代表 Sublime 能调用它——尤其 macOS/Linux 图形界面下、Windows 用了 nvm 切换 Node 版本后，sass 路径就失效了。
必须手动定位并填入绝对路径：
- 终端运行
which sass（macOS/Linux）或where sass（Windows），拿到类似/opt/homebrew/bin/sass或C:UsersMeAppDataRoaming pmsass.cmd的结果 - 打开 Preferences → Package Settings → Sass-Autocompile → Settings
- 在右侧用户设置中加一行：
"sass_path": "/opt/homebrew/bin/sass"（注意：只填可执行文件路径，不带参数） - 保存后重启 Sublime，再试一次保存 .scss 文件
Sass-Autocompile 编译卡住或静默失败
这个插件默认只监听当前激活的 tab，改了 _mixins.scss 但没切回 main.scss 保存，CSS 就不会更新——它不自动追踪 @use 或 @import 依赖链。
常见表现：变量报 undefined variable、编译无输出、控制台空空如也。
解决办法：
- 保存前确保主入口文件（如
main.scss）处于激活状态 - 按
Ctrl+`打开 Sublime 控制台，观察是否有 stderr 输出，比如Error: Can't find stylesheet to import就说明include_paths没配对 - 在插件设置里加
"include_paths": ["src/scss", "node_modules/bootstrap/scss"]（路径用正斜杠，相对项目根目录） - 避免路径含中文、空格或长路径；Windows 上建议项目放
C:dev这类短路径下
想让不同 .scss 文件输出到不同目录（比如 components/ → css/components/）
Sass-Autocompile 的 output_dir 是扁平化设计：所有文件都扔进同一个目录，不保留源结构。它不支持层级映射，硬配 "output_dir": "css/components" 会导致 button.scss 和 header.scss 都挤在 css/components/ 里，没法区分归属。
真要按源目录结构输出，得换方案：
- 用
LiveSassCompiler插件，配置"saveTo": "/dist/css/"+"save_generated_files": true，它支持嵌套路径映射 - 或写自定义构建系统：
{ "cmd": ["sass", "$file", "${file_path}/../dist/css/${file_path/.*\//}/${file_base_name}.css"], "selector": "source.scss", "shell": true, "working_dir": "$file_path" }（注意：正则替换部分仅 Sublime 支持，Windows 上需测试路径分隔符） - 别指望 Sass-Autocompile 自己“猜”路径关系——它不做路径解析，只做单文件直译
多个 Sass 版本共存时，如何指定某项目用 Dart Sass 4.x，另一项目用 3.x
Sass-Autocompile 不支持 per-project 指定 sass 可执行文件。它全局只认一个 sass_path，换版本就得改设置、重启编辑器，没法并发切换。
如果你真需要多版本并行（比如维护老项目用 Sass 3.5，新项目用 Dart Sass 4.0+），必须绕过插件：
- 每个项目根目录下建独立
.sublime-build文件，里面硬编码对应版本的sass绝对路径，例如/usr/local/bin/sass-3.5 - 用
SublimeOnSaveBuild插件，配合项目级构建系统自动触发，而非依赖 Sass-Autocompile 的全局监听 - 放弃“自动保存即编译”的幻想——高并发多版本场景下，手动按
Ctrl+B选对应构建系统，反而更可控、更少冲突
真正难的不是怎么配，而是接受：Sass-Autocompile 本质是个单版本、单路径、单项目的轻量封装。想让它扛多版本并发，就像让记事本跑 Docker —— 不是不能，是绕路比重选工具还费劲。
