Sublime Text 保存时触发格式化需监听 on_post_save_async 事件，避免阻塞；推荐用 SublimeOnSaveBuild 插件配 .sublime-build 文件，或手写插件注意路径处理、去抖及配置一致性。
Sublime Text 保存时触发格式化命令的关键是 on_post_save_async
Sublime Text 本身不内置“保存即格式化”开关，必须靠插件或自定义插件逻辑实现。核心机制是监听 on_post_save_async 事件——它在文件写入磁盘后异步触发，避免阻塞编辑器响应。同步事件（如 on_pre_save）容易卡住保存流程，尤其调用外部命令时更不可靠。
常见错误现象：保存后没反应、格式化延迟数秒、偶尔失败但无报错。多数是因为用了 on_pre_save 或未正确处理异步执行；还有人误以为装了 JsPrettier 或 Python Black 插件就自动生效，其实默认仍需手动调用 ctrl+shift+H 或右键菜单。
- 务必确认你用的是 Sublime Text 3 或 4（
on_post_save_async在 ST2 中不可用） - 若项目根目录有
.prettierrc、pyproject.toml等配置，确保格式化命令能正确读取（路径上下文默认是当前文件所在目录） - 不要在插件中直接用
subprocess.call阻塞主线程；改用subprocess.Popen+ 回调，或交由插件如SublimeOnSaveBuild转发为 build system
用 SublimeOnSaveBuild 插件最省事，但得配好 build system
这个插件把“保存”映射为一次 build 执行，绕过手写监听逻辑，适合不想碰 Python 插件代码的用户。但它依赖 build system 定义是否精准——不是装上就灵，关键在 .sublime-build 文件里怎么写命令和环境。
使用场景：团队统一用 Prettier 格式化 JS/TS，或用 black 处理 Python，且希望所有成员行为一致。
- 安装插件后，新建
Prettier.sublime-build，内容包含："cmd": ["prettier", "--write", "$file"] -
$file是必须的，不能写成.或$file_path，否则 prettier 会跳过单文件模式 - 如果 prettier 不在
PATH，得显式写绝对路径，或在"env"里补全"PATH"（Windows 用户特别容易在这里失败） - 加
"quiet": true可隐藏控制台弹窗，但出错时也看不到错误信息，调试阶段建议先关掉
自己写插件？重点防住 view.is_dirty() 和编码问题
手写插件灵活性高，但两个坑高频出现：一是保存瞬间文件可能还在写入，view.is_dirty() 返回 True 导致重复触发；二是中文路径或含空格路径传给 shell 时崩掉，报错类似 "No such file or directory"。
性能影响很小，只要不每次保存都启动 Node.js 进程（比如用 prettierd 长驻服务更好），但兼容性要注意：ST4 的 sublime.View API 和 ST3 有细微差别，比如 view.file_name() 在未保存的新建标签页返回 None，必须判空。
- 检查
view.file_name()是否为None，跳过未命名文件 - 用
shlex.quote()包裹文件路径（Python 插件中），避免空格引发命令截断 - 加个简单去抖：记录上次格式化时间戳，100ms 内重复保存忽略
- 错误输出别只 print，用
sublime.status_message("Prettier failed: ...")推送到状态栏，不然根本不知道哪错了
CI/CD 前置校验和本地格式化必须用同一套规则
很多人本地开了自动格式化，CI 却报 lint 错误，根源常是配置不一致：比如本地 prettier 版本是 3.0，CI 用的是 2.8；或者本地用了 .prettierrc.js，CI 的 Docker 镜像只认 JSON 格式。
参数差异直接影响结果：例如 prettier --semi false 和 --semi true 生成的分号风格完全不同；black --line-length 88 和默认 88 以外的值也会让 CI 检查失败。
- 把格式化命令固化进
package.jsonscripts 或Makefile，CI 直接复用，避免本地和 CI 各写一套 - 在 Sublime 插件里硬编码命令时，别写死版本号（如
"prettier@3.0.0"），改用全局安装的prettier - 如果项目用
editorconfig，注意它和 prettier/black 的缩进、换行设置冲突，优先以格式化工具为准，.editorconfig只留编辑器提示项
真正麻烦的从来不是怎么让 Sublime 保存时跑命令，而是确保那条命令在任何机器、任何环境下输出完全一致的结果。配置文件放哪、谁来维护、升级时要不要同步更新 CI 镜像——这些才是卡点。
