sublime text 4 必须使用 sublimeonsavebuild 插件实现保存时自动运行脚本，需配置匹配的 .sublime-build 文件并启用对应构建系统，否则无反应；旧版 st3 避免使用已失效的 onsave。
Sublime Text 本身不支持原生的“保存时自动运行脚本”，必须借助插件实现，最常用且稳定的是 SublimeOnSaveBuild（注意不是 OnSave —— 后者已多年未维护、不兼容 Sublime Text 4）。
确认 Sublime Text 版本与插件兼容性
Sublime Text 4（Build 4126+）用户必须用 SublimeOnSaveBuild；旧版（ST3）虽可选 OnSave，但存在路径解析错误、Python 环境混乱等问题。ST4 下 OnSave 插件会静默失效，保存无反应，也无报错提示。
- 打开
Help → About Sublime Text查看版本号 - 若为 ST4，请直接跳过所有
OnSave教程，只装SublimeOnSaveBuild - 该插件依赖
sublime-build系统，因此需先配置好对应语言的.sublime-build文件
安装 SublimeOnSaveBuild 并启用
通过 Package Control 安装后，需手动启用并绑定构建系统。它不会自动触发任何命令，必须显式指定 build_system 或让 Sublime 自动匹配当前语法的默认构建系统。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package，回车后搜SublimeOnSaveBuild - 安装完成后，打开
Preferences → Package Settings → SublimeOnSaveBuild → Settings - 在右侧用户设置中填入：
{
"build_on_save": true,
"build_on_save_delay": 0.2,
"only_for_files_matching": ["\.py$", "\.js$", "\.sh$"]
}
"only_for_files_matching" 是正则数组，控制哪些文件后缀触发构建；"build_on_save_delay" 避免快速连保存导致重复执行（尤其配合 ESLint/Prettier 时有用）。
确保对应语言有可用的 build system
SublimeOnSaveBuild 不执行脚本，它只是调用 Sublime 的 build 功能。如果你没配过 Python/Node/Shell 的构建系统，保存时什么都不会发生——也不会报错。
- 以 Python 为例：菜单栏
Tools → Build System → New Build System…，粘贴以下内容并保存为Python-Auto.sublime-build：
{
"shell_cmd": "python -u "$file"",
"file_regex": "^\s*File "(...*?)", line ([0-9]*)",
"selector": "source.python"
}
- 然后在文件内按
Ctrl+Shift+P输入Set Build System: Python-Auto手动选中（或设为默认） - 保存
.py文件时，底部面板才会弹出 Python 执行结果 - Shell 脚本同理：需新建
Shell-Auto.sublime-build，"shell_cmd": "bash "$file""，并确保文件有执行权限（chmod +x）
常见失败原因与绕过技巧
很多人配完仍不生效，核心问题往往不在插件本身，而在构建系统的上下文隔离或输出捕获机制。
- 构建系统默认不显示成功退出的 stdout（只显示 stderr 或非零退出码），所以
echo "ok"可能看起来“没运行” - 某些命令（如
prettier --write）需用"shell_cmd": "prettier --write "$file" && echo '✅ Formatted'"强制输出 - Windows 用户注意路径分隔符：
"shell_cmd": "python -u "$file_path\\$file_name""（双反斜杠）或改用正斜杠 - 如果只想运行简单命令（比如保存时自动加时间戳），建议改用
sublime_plugin.EventListener写轻量插件，比构建系统更可控
真正难的不是“怎么触发”，而是“如何让命令在正确环境、正确路径、正确权限下安静执行并反馈结果”。构建系统是 Sublime 的通用通道，但也因此受其沙箱限制——这点常被忽略。
