Sublime Text自动编译需插件（如AutoBuild）监听保存事件并调用已配置的.sublime-build构建系统，构建系统必须正确放置于Packages/User/目录、匹配selector、且cmd中命令可在终端执行；watch类命令（如tsc -w）不应直接写入构建系统。
自动编译不是原生功能，必须靠插件+构建系统协同工作
Sublime Text 本身没有“保存即编译”的钩子，所谓自动编译，本质是插件监听 on_post_save 事件后，调用已配置好的构建系统（.sublime-build 文件）。如果构建系统不存在、未激活或路径错误，插件再怎么监听也无济于事。
常见错误现象：Build system not found、保存后控制台完全没反应、或报错 command not found。这基本说明构建系统没配好，而不是插件没装对。
- 确认当前文件右下角状态栏显示了正确语法（如
TypeScript、Sass），否则selector不匹配，构建系统不会被自动选中 -
.sublime-build文件必须放在Packages/User/目录下，且后缀严格为.sublime-build；放错位置或命名成.json都无效 - 构建系统中
"cmd"或"shell_cmd"调用的命令（如tsc、sass、lessc）必须能在终端直接执行；建议先在命令行跑通再搬进配置
推荐用 AutoBuild，别碰 SublimeOnSaveBuild
SublimeOnSaveBuild 已多年未更新，在 Sublime Text 4 下容易重复触发、卡 UI 或静默失败；AutoBuild 更轻量、响应快，且支持精准过滤。
安装后需手动编辑 AutoBuild.sublime-settings，默认不生效：
-
"build_on_save": true—— 开启保存触发 -
"file_patterns": ["*.ts", "*.scss", "*.less"]—— 必须显式声明，否则所有文件都走构建，可能误触无关命令 -
"build_timeout": 5000—— TypeScript 增量编译慢时防卡死，超时后报Build interrupted
注意：如果构建命令输出大量日志（比如 Webpack watch），建议在对应 .sublime-build 中加 "quiet": true，避免频繁弹出面板打断编码节奏。
构建系统里用 variants 分离“保存检查”和“手动构建”
你通常不希望每次保存都生成完整产物（比如全量 tsc --build 或 webpack --mode=production），而是只做快速类型检查或增量编译。这时不能只写一个 "cmd"，得靠 variants 定义不同模式，并让插件调用指定 variant。
例如 TypeScript 构建系统可这样写：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
{
"selector": "source.ts",
"working_dir": "$file_path",
"variants": [
{
"name": "Check",
"cmd": ["tsc", "--noEmit", "$file"]
},
{
"name": "Build",
"cmd": ["tsc", "$file"]
}
]
}
然后在 AutoBuild.sublime-settings 中指定：
-
"build_variant": "Check"—— 保存时只执行检查 - 手动按
Ctrl+Shift+B再选Build变体，才真正输出 JS
同理适用于 Sass：sass --watch 不适合放进构建系统（它会常驻），应改用 sass --style=compressed --no-source-map $file $file_path/${file_base_name}.css 做单次编译。
Watch 模式慎用：它不等于自动编译，而是另起进程常驻
像 tsc -w、sass --watch、webpack --watch 这类命令启动后会持续监听，不退出。它们不适合塞进 Sublime 的构建系统——因为 Sublime 期望构建命令执行完就结束，否则会卡住面板、无法响应后续操作。
如果你真要用 watch 模式，推荐方式是：
- 终端单独开一个窗口运行
tsc -w或npm run watch - 配合
LiveReload插件监听输出目录（如dist/或css/）变化，自动刷新浏览器 - 不要指望 Sublime 自己管理这个长进程；它不是 IDE，没进程生命周期管理能力
真正容易被忽略的是：watch 进程和 Sublime 构建系统是两套独立机制，混用会导致行为不可控——比如保存一次触发两次编译，或某次保存后 watch 进程意外退出却没人通知你。
