sublime text保存时自动编译依赖构建系统而非原生钩子，需先配置有效的.sublime-build文件；推荐使用autobuild插件并显式设置file_patterns和build_on_save，配合variants实现保存校验与手动构建分离。
Sublime Text保存时自动编译依赖构建系统，不是靠插件“自动触发”
Sublime Text 本身不提供“保存即编译”的原生钩子，所谓“自动编译”本质是：把保存动作和构建命令（build）绑定，靠第三方插件监听 on_post_save 事件来调用构建。这意味着——你必须先有可用的构建系统（.sublime-build 文件），否则插件再智能也无从编译。
常见错误现象：Build system not found 或保存后静悄悄没反应，大概率是构建系统未配置或未激活。
- 确认当前文件已关联语法（如
JavaScript、TypeScript），且存在对应构建系统（可通过Tools → Build System菜单看到） - 构建系统必须支持
shell_cmd或cmd启动命令，且路径、参数正确（比如tsc -p .要求项目根目录有tsconfig.json） - 若使用
npm run build类命令，需确保shell_cmd中指定了正确的工作目录（用working_dir字段）
推荐用 AutoBuild 插件而非 SublimeOnSaveBuild
SublimeOnSaveBuild 是早期流行方案，但已多年未更新，对 Sublime Text 4 兼容性差，容易在保存时重复触发或阻塞 UI；AutoBuild 更轻量、响应快，且支持条件过滤（比如只对 .ts 文件生效）。
安装后默认不启用，需手动配置 AutoBuild.sublime-settings：
{
"build_on_save": true,
"file_patterns": ["*.ts", "*.jsx", "*.tsx"],
"build_timeout": 5000
}
-
file_patterns必须显式声明，否则对所有文件生效，可能误触无关构建 -
build_timeout防止卡死，尤其 TypeScript 增量编译慢时，超时后会终止并报错Build interrupted - 如果构建命令本身输出大量日志，建议在
.sublime-build中加"quiet": true，避免频繁弹出面板干扰
构建系统中用 variants 区分保存编译与手动编译
你可能希望：保存时只做快速检查（如 tsc --noEmit），而手动按 Ctrl+B 才生成代码。这时不能只靠一个构建系统，得用 variants 定义多个模式，并让插件调用指定 variant。
例如，定义 TypeScript.sublime-build：
{
"shell_cmd": "tsc --noEmit",
"variants": [
{
"name": "Build & Emit",
"shell_cmd": "tsc"
}
]
}
-
AutoBuild默认调用主构建（即--noEmit版本），符合“保存即校验”预期 - 手动构建时，可按
Ctrl+Shift+P → Build With → TypeScript: Build & Emit显式触发输出 - 注意：
name字段必须唯一，且不能含空格以外的特殊字符，否则插件无法识别
Node.js 环境路径问题最常导致“编译命令找不到”
Sublime Text 在 macOS/Linux 下通常无法继承 shell 的 $PATH，Windows 则常找不到 npm 或全局安装的 tsc。表现为构建面板里出现 /bin/sh: tsc: command not found。
- macOS/Linux：在
.sublime-build中显式写全路径，比如"shell_cmd": "/opt/homebrew/bin/tsc -p ."（用which tsc查） - Windows：优先用
cmd替代shell_cmd，并指定完整路径，如"cmd": ["C:\Users\xxx\AppData\Roaming\npm\tsc.cmd", "-p", "."] - 更通用解法：在 Sublime Text 启动脚本里注入环境变量（macOS 可用
subl命令从终端启动；Windows 可改快捷方式目标为cmd /c set PATH=... & start sublime_text.exe）
真正麻烦的不是配置多，而是错误信息太简略——它不会告诉你 PATH 缺失，只会说命令不存在。盯住构建面板第一行输出，比反复重装插件有用得多。
