Sublime Text 本身不支持保存时自动编译，需依赖插件（如AutoBuild）监听on_post_save事件并调用已配置的.sublime-build构建系统；构建系统必须存于Packages/User/目录、JSON格式正确、selector严格匹配syntax scope（如"source.ts"），且文件已保存才能展开$file等变量。
Sublime Text 本身不支持保存时自动编译，所谓“自动编译”是靠插件监听 on_post_save 事件后，主动调用你已配好的构建系统（.sublime-build 文件）来实现的。没有可用的构建系统，插件再智能也无事可做。
构建系统必须存在且被正确激活
这是最常卡住的地方：保存后没反应、控制台报 Build system not found，基本都是构建系统缺失或未匹配。
- 先确认当前文件右下角显示的是正确的 syntax，比如
TypeScript（不是Babel或JavaScript），SCSS 文件要显示Sass或SCSS - 打开
Tools → Build System菜单，必须能看到你命名的构建项（如TypeScript、Sass），否则说明.sublime-build文件没放对位置（应存于Packages/User/目录下）或 JSON 格式有误 - 构建系统中
"selector"字段必须严格匹配 syntax scope，例如 TypeScript 必须写"source.ts"，SCSS 必须写"source.scss"；写成typescript、.ts或source.typescript都无效 -
$file等变量只在已保存的文件中展开；未保存的Untitled标签页下，命令会变成空参数，直接失败
选对插件：AutoBuild 比 SublimeOnSaveBuild 更稳
SublimeOnSaveBuild 在 Sublime Text 4 下兼容性差，容易重复触发或阻塞 UI；AutoBuild 更轻量、响应快，且支持按文件类型过滤。
- 安装后需手动编辑
AutoBuild.sublime-settings，不能只开开关 - 必须显式设置
"build_on_save": true和"file_patterns": ["*.ts", "*.scss"]，否则默认对所有文件生效，可能误触无关构建 -
"build_timeout": 5000建议加上，防止 TypeScript 增量编译卡死导致 UI 冻结 - 别同时装多个保存监听插件（如 AutoBuild + SublimeOnSaveBuild），它们会互相劫持，结果是构建不触发也不报错
构建命令路径和工作目录必须真实可用
终端里能跑通的命令，在 Sublime 里不一定行——图形界面启动的 Sublime 不读 shell 的 PATH，nvm 切换的 Node 版本、全局安装的 sass 或 tsc 很可能不可见。
- Windows 下用
where tsc或where sass查绝对路径，然后在构建系统里硬编码，例如："cmd": ["C:\Users\xxx\AppData\Roaming\npm\tsc.cmd", "--noEmit", "$file"] - macOS/Linux 下用
which sass，路径填入"cmd"数组，避免依赖 shell 解析 -
"working_dir"推荐设为"${project_path:${folder}}"，而不是"$file_path"，否则tsconfig.json或sass --load-path可能找不到 - 项目路径含中文、空格或括号？大概率静默失败——这不是 bug，是大多数 CLI 工具的限制，得改路径
用 variants 分离“保存校验”和“手动输出”
你通常不希望每次保存都生成 JS 或 CSS 文件，而是只做语法检查；真正输出交给手动触发。这靠构建系统的 variants 实现，不是靠插件配置。
- 在
TypeScript.sublime-build中定义主命令为tsc --noEmit，再加一个variants项叫"Build & Emit"，里面写"shell_cmd": "tsc" - AutoBuild 默认调用主构建（即校验模式），符合“保存即反馈”的预期
- 手动构建时按
Ctrl+Shift+P → Build With → TypeScript: Build & Emit，就能输出 JS - 别指望插件自动识别 variant 名字——它只认构建系统名，variant 是构建系统内部的事
真正复杂的地方不在 JSON 怎么写，而在于环境是否干净：图形界面启动的 Sublime 不继承 shell 环境变量，nvm 切换后全局命令失效、项目路径含空格、tsconfig.json 位置不对……这些细节不逐个验证，配置再标准也没用。
