sublime text 的保存自动格式化需插件监听 on_post_save_async、cli 可被环境找到、配置匹配语法类型；常见失效原因包括插件未启用自动保存、cli 路径错误、多插件冲突及未命名文件不触发。
Sublime Text 本身不提供保存自动格式化功能，所有「保存即排版」行为都依赖插件调用外部 CLI 工具（如 prettier、black、autopep8）完成。装插件 ≠ 自动生效，关键在三件事：插件是否监听了 on_post_save_async、CLI 是否能被 Sublime 环境找到、配置项是否匹配当前语法类型。
怎么确认你用的插件真支持 on_save？
很多插件名字带“format”或“prettify”，但实际只提供手动命令（比如 html_css_js_prettify），并不监听保存事件。这类插件即使装了，也不触发自动格式化。
-
JsPrettier支持"auto_save": true，但必须在插件设置里显式开启，不是安装即开 -
Sublime-Code-Formatter靠"format_on_save": true控制，且默认不启用 -
AutoPEP8插件需设"on_save": true，否则只响应右键菜单 - 已停止维护的
HTML-CSS-JS Prettify在 ST4 下大概率静默失败，报UnicodeDecodeError或无反应
为什么保存后没反应？90% 是 CLI 路径或环境变量问题
Sublime 启动方式直接影响它能否读到 shell 的 PATH。从桌面图标启动时，常找不到 prettier 或 black；终端执行 subl 打开才可靠。
- 先在终端验证：运行
prettier --version或black --version，确保能输出版本号 - 查 CLI 实际路径：macOS/Linux 用
which prettier，Windows 用where prettier - 若用了
pyenv或conda，black可能不在全局 PATH，必须在插件设置中填完整路径，例如"black_cmd": ["/Users/xxx/.pyenv/shims/black"] - JsPrettier 需要
"prettier_cli_path"，不能只写"prettier"—— 它不会走 shell 查找逻辑
怎么配才不冲突、不漏文件？
多个格式化插件共存会抢 on_post_save 事件，导致某类文件突然不格式化。建议按语言统一归口，别混用 JsPrettier + Sublime-Code-Formatter + AutoPEP8。
- JS/TS/JSON 用
JsPrettier，配"syntaxes": ["source.js", "source.ts", "source.json"]显式扩展支持范围 - Python 用
Sublime-Code-Formatter+black，避免AutoPEP8和black对缩进、引号等规则打架 - 未命名 tab（
untitled）不会触发任何on_save行为，必须先Ctrl+S保存成真实文件 -
.vue或.svelte文件里的 JS 块，得靠插件识别嵌入语法；若 Sublime 当前视图语法是text.html.vue而非source.js，JsPrettier就不会介入
不想装插件？用 .sublime-build 替代更可控
如果你只是想让保存触发一次 prettier --write 或 black -q -，不用插件也能做，而且路径、参数、错误反馈更透明。
- 菜单 → Tools → Build System → New Build System…
- 填入：
{ "cmd": ["prettier", "--write", "$file"], "selector": "source.js, source.ts", "shell": true, "working_dir": "$file_path" } - 保存为
Prettier.sublime-build（文件名必须一致） - 再加一条命令绑定：
{ "commands": ["Prettier"] }到Preferences → Key Bindings，把Ctrl+S同时映射到保存和构建 - 好处是：不依赖插件生命周期，不抢事件，出错时控制台直接打印 CLI 报错
真正卡住人的从来不是“怎么开开关”，而是 CLI 工具、Sublime 运行环境、文件语法识别这三者没对齐。一个字符的路径错误，或者一次 pyenv shell 切换，就足以让格式化静默失效——而 Sublime 不会告诉你哪里错了。
