Sublime如何启用保存时自动运行格式化脚本？（CI/CD前置）

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.json scripts 或 Makefile，CI 直接复用，避免本地和 CI 各写一套
• 在 Sublime 插件里硬编码命令时，别写死版本号（如 "prettier@3.0.0"），改用全局安装的 prettier
• 如果项目用 editorconfig，注意它和 prettier/black 的缩进、换行设置冲突，优先以格式化工具为准，.editorconfig 只留编辑器提示项

真正麻烦的从来不是怎么让 Sublime 保存时跑命令，而是确保那条命令在任何机器、任何环境下输出完全一致的结果。配置文件放哪、谁来维护、升级时要不要同步更新 CI 镜像——这些才是卡点。