Sublime Text 本身不支持保存后自动编译，必须依赖插件（如AutoBuild）监听on_post_save事件并调用已配置的.sublime-build构建系统；构建系统须置于Packages/User/目录、匹配文件syntax selector、且cmd中命令可在终端执行。
Sublime Text 本身不支持“保存后自动运行编译系统”，必须靠插件监听保存事件并主动调用已配置的构建系统；没配好 .sublime-build 文件，插件再怎么触发也只会报 Build system not found 或静默失败。
为什么保存后没反应？先查构建系统有没有、能不能用
自动编译不是 Sublime 原生能力，本质是插件在 on_post_save 时调用 build 命令——这要求你提前有可用的构建系统，且它能被当前文件匹配上。
- 打开
Packages/User/目录（Preferences → Browse Packages…），确认存在XXX.sublime-build文件，后缀必须是.sublime-build，不能是.json或其他 - 右下角状态栏必须显示正确语法（如
source.ts、source.python），否则selector不匹配，构建系统不会被自动选中 - 在
Tools → Build System菜单里能看到你的构建系统名，且当前是选中状态（前面有对勾）；如果显示None，说明没激活 -
cmd或shell_cmd中调用的命令（如tsc、python、sass）必须能在终端直接执行；建议先在命令行跑通tsc -p .再写进配置
该装哪个插件？AutoBuild 是当前最稳的选择
SublimeOnSaveBuild 已多年未更新，在 Sublime Text 4 下容易重复触发、卡 UI 或静默失败；AutoBuild 更轻量、响应快，且支持按文件类型精准过滤，推荐作为首选。
- 用
Package Control: Install Package安装AutoBuild - 安装后默认不生效，必须手动编辑
AutoBuild.sublime-settings（Preferences → Package Settings → AutoBuild → Settings） - 至少启用这两项：
"build_on_save": true和显式声明"file_patterns": ["*.ts", "*.py", "*.scss"]；不设file_patterns会导致所有文件都触发构建，可能误跑无关命令 - 可加
"build_timeout": 5000防止 TypeScript 增量编译卡死，超时后会报Build interrupted
构建系统里怎么写 cmd 才不踩坑？
.sublime-build 文件里写错路径、参数或工作目录，会导致命令找不到、报错退出、或生成文件位置不对。尤其注意 Windows 路径和 shell 环境差异。
- Python 运行脚本：用
["python", "-u", "$file"]，-u禁用缓冲，确保print实时输出；Windows 若没配环境变量，得写死路径，如["C:\Python39\python.exe", "-u", "$file"] - TypeScript 编译：必须设
"working_dir": "$project_path"，否则tsc -p .找不到tsconfig.json - Sass/SCSS 编译：用
"shell_cmd": "sass $file:$file_base_name.css --style=compressed"，别用sass --watch——那是长期进程，不适合构建系统 - 需要区分保存检查和手动构建？用
variants：比如保存时只跑tsc --noEmit，手动按Ctrl+B再走完整编译流程
常见错误现象和对应解法
保存后控制台没输出、弹出错误面板但内容为空、或反复提示 command not found，基本都指向同一类问题：构建系统与插件没对齐。
-
Build system not found：构建系统文件不在Packages/User/，或命名错误（比如写成Python.json） - 保存后完全没反应：插件没启用
build_on_save，或file_patterns没覆盖当前文件后缀 - 报
File not found或路径错误：构建系统里没设working_dir，导致相对路径解析失败 - 输出日志刷屏干扰编码：在构建系统里加
"quiet": true，抑制面板自动弹出
真正卡住人的地方往往不是插件装没装，而是构建系统里 working_dir 没设对、selector 匹配不上、或者 cmd 调用的命令根本不在 $PATH 里——这些细节不验证，光换插件没用。
