sublime text 保存时执行 shell 命令靠 on_post_save_async 插件事件 + subprocess.popen() 异步调用；必须禁用同步方法、正确处理路径与环境，且插件修改后需手动重载。
Sublime Text 保存时执行 Shell 命令靠什么？
靠 on_post_save_async 插件事件 + subprocess 调用系统命令。Sublime 本身不提供“保存钩子”配置项，必须写 Python 插件实现。官方 API 明确要求异步执行（避免阻塞 UI），所以不能用 on_post_save（已弃用且同步阻塞）。
常见错误现象：os.system() 或 subprocess.call() 在保存后卡住编辑器、命令没执行、报 BlockingIOError 或直接静默失败。
- 必须用
subprocess.Popen()配合shell=True（Windows 下尤其关键） - 路径含空格或中文时，命令字符串需用双引号包裹可执行文件路径，比如
"C:\Program Files\nodejs\node.exe" - 不要在插件里写
time.sleep()或等待子进程结束——用户只关心“保存完就跑”，不关心它啥时候跑完
怎么写一个最小可用的自动执行插件？
在 Sublime TextPackagesUser 目录下新建 auto_shell_on_save.py，内容如下：
import sublime
import sublime_plugin
import subprocess
import os
<p>class AutoShellOnSave(sublime_plugin.EventListener):
def on_post_save_async(self, view):</p><h1>只对特定后缀文件生效（按需修改）</h1><pre class='brush:php;toolbar:false;'> if not view.file_name() or not view.file_name().endswith(".js"):
return
cmd = ["npm", "run", "lint"]
# Windows 下建议用 shell=True + 字符串形式，兼容性更好
if os.name == "nt":
cmd = "npm run lint"
subprocess.Popen(
cmd,
cwd=os.path.dirname(view.file_name()),
shell=os.name == "nt",
stdout=subprocess.DEVNULL,
stderr=subprocess.DEVNULL
)注意：这里用 subprocess.DEVNULL 忽略输出，避免弹窗或日志干扰；cwd 设为当前文件目录，确保命令在项目根下运行。
- 若要支持多命令，别拼接字符串，改用
subprocess.run()多次调用（但得确保异步，仍推荐Popen） - 别在插件里硬编码绝对路径，用
view.window().folders()[0]获取项目根更可靠 - 如果命令依赖环境变量（如 nvm 管理的 node），Windows 用户需确认 Sublime 启动方式——从开始菜单启动会丢失终端环境，建议从命令行用
subl .启动
为什么改了插件代码没生效？
Sublime 不自动重载插件模块，改完 .py 文件必须手动触发重载或重启。最稳的方式是：按 Ctrl+Shift+P → 输入 Package Control: Satisfy Dependencies（无用）→ 实际应输入 Developer: Reload Plugin，再选你的插件名。
常见错误现象：ImportError、函数没被调用、print() 不输出（因为 Sublime 的 console 不捕获插件 stdout）、view.file_name() 返回 None（新建未保存文件）。
- 调试时把
print()换成sublime.status_message("auto shell fired")，肉眼可见 -
view.is_dirty()和view.is_primary()可过滤掉临时预览标签页或未保存缓冲区 - 插件名必须是
xxx.py格式，类名必须继承sublime_plugin.EventListener，且类名不重要，但文件名影响加载顺序
要不要用第三方包比如 ShellCommand 或 AutoRun？
可以，但没必要。这两个包本质也是封装 on_post_save_async + subprocess，还额外加了 JSON 配置层。问题在于：配置项模糊（比如 "cmd" 字段到底支持数组还是字符串）、Windows 路径处理不一致、更新滞后导致和新版本 Sublime 兼容出问题。
真正难的不是“怎么跑命令”，而是“什么时候跑、在哪跑、跑失败了要不要提示”。这些逻辑自己写三行就能控住，加一层包反而多两个 bug。
- 如果你只需要对单一项目生效，直接在项目根放
.sublime-project，里面加"settings": {"save_on_focus_lost": true}配合插件更稳妥 - 如果命令执行耗时超过 1 秒，用户连续保存两次可能触发并发，
Popen不会自动排队，得自己加个简单锁（比如用view.settings().set("is_running_shell", True)）
最易忽略的点：Sublime 的插件目录权限。macOS 上如果用 Homebrew 安装 Sublime，Packages/User/ 可能被沙盒限制，命令执行失败却没报错。先在终端里模拟相同命令和路径，确认能跑通，再进插件。事情说清了就结束
