Sublime Text 保存时自动格式化需依赖插件（如JsPrettier/SublimeBlack）监听on_post_save_async事件并调用外部工具，必须启用插件钩子且确保命令路径正确；macOS/Windows路径配置、语法类型识别、排除node_modules等细节均影响生效。
Sublime 保存时自动格式化不是开关一开就灵
Sublime Text 本身不提供 format_on_save 这类内置功能，所有“保存即格式化”行为都依赖插件监听 on_post_save_async 事件并调用外部工具。装了插件 ≠ 自动生效，必须确认两件事：插件是否真正启用了保存钩子，以及它调用的命令（如 prettier、black）能否在 Sublime 的运行环境中被找到。
- 常见错误现象：
Ctrl+S后毫无反应，控制台（View → Show Console）里也没报错——大概率是插件没开启自动触发，或 PATH 不一致导致命令找不到 - macOS 用户尤其容易中招：终端能跑
prettier --version，但 Sublime 启动方式（比如从 Dock 点开）不加载 shell 配置，which prettier的路径得手动填进插件配置 - Windows 用户注意：
prettier.cmd是可执行文件，路径中反斜杠要写成双反斜杠，例如"prettier_cli_path": "C:\Users\name\AppData\Roaming\npm\prettier.cmd" - 别用
on_pre_save：它在文件写入磁盘前触发，此时内容可能还没落盘，格式化会基于旧内容，还容易卡住保存流程
JsPrettier：JS/TS/HTML 等前端文件最稳的选择
它不自己实现 Prettier，而是调用你本地安装的 CLI，兼容性好、支持语言多，且对配置文件（如 .prettierrc、package.json）读取准确。
- 必须先全局安装：
npm install -g prettier（或用yarn global add prettier） - 安装插件后，在
Preferences → Package Settings → JsPrettier → Settings – User中写入：{ "auto_format_on_save": true, "prettier_cli_path": "/usr/local/bin/prettier", "auto_format_on_save_excludes": ["*/node_modules/*", "*/dist/*"] } -
auto_format_on_save_excludes强烈建议加上：否则一不小心保存了node_modules/react/index.js，可能卡死整个编辑器 - 如果项目用的是 pnpm 或局部
prettier，可以改用"prettier_cli_path": "./node_modules/.bin/prettier"，但要注意相对路径上下文是当前文件所在目录
SublimeBlack：Python 文件想和 VS Code 体验一致就选它
专为 black 设计，轻量、无多余依赖，能自动识别 pyproject.toml 中的 [tool.black] 配置，不用在 Sublime 里重复写 line-length 或 skip-string-normalization。
- 先确保系统已装：
pipx install black（比pip install black更干净，避免虚拟环境冲突） - 在
Preferences → Package Settings → SublimeBlack → Settings – User中启用：{ "format_on_save": true, "black_command": ["black"], "format_on_save_timeout_ms": 1000 } -
black_command值是数组：如果black不在 PATH，直接填绝对路径，如["/opt/homebrew/bin/black"] - 新建未保存的 Python 标签页（
view.file_name()为None）不会触发格式化——这是正常行为，插件做了空值防护
自己写插件 or 用 SublimeOnSaveBuild？看你要不要绕过配置细节
如果你希望完全掌控触发逻辑（比如加防抖、按文件大小跳过、只对 Git 跟踪文件生效），手写插件是唯一办法；但如果只是想让保存 = 执行一次 prettier --write $file，SublimeOnSaveBuild 更省事，也更稳定。
- 用
SublimeOnSaveBuild：装完插件后，新建Prettier.sublime-build，内容为：{ "cmd": ["prettier", "--write", "$file"], "selector": "source.js, source.ts, text.html.basic", "quiet": true } -
$file是关键：不能写成.或$file_path，否则prettier会退化为目录扫描模式，极慢且不可控 - 手写插件时两个高频坑：
view.is_dirty()在保存瞬间可能仍返回True，导致重复触发；含空格或中文路径传给subprocess.Popen会崩，必须用shlex.quote()包裹 - ST4 的 API 和 ST3 有细微差别，比如
view.encoding()返回值类型不同，跨版本适配需加判断
最易被忽略的一点：格式化插件是否真正“知道”你当前文件的语法类型。比如一个 .js 文件被 Sublime 误判为 Plain Text，哪怕配置全对，也不会触发任何格式化——右下角状态栏看看当前 syntax 是什么，必要时手动 Ctrl+Shift+P → Set Syntax → JavaScript。
