Sublime Text 保存时自动格式化需插件+CLI工具+路径配置三者缺一不可；JsPrettier配prettier_cli_path、auto_format_on_save等键值，Python推荐black或autopep8二选一，注意PATH与语法scope限制。
Sublime Text 本身不支持保存时自动格式化，所有“一保存就整齐”的效果都依赖插件 + 本地 CLI 工具 + 精确路径配置三者同时成立；缺一个环节，就静默失效——而且控制台通常不报错，只让你反复点保存却没反应。
JsPrettier 怎么配才能让 JS/TS/JSON 保存时自动格式化
JsPrettier 是目前 ST4 下最稳的前端格式化方案，但它不会自动找 prettier 命令，必须手动填死路径。
- 先确保全局装好：
npm install -g prettier（或yarn global add prettier），然后终端运行prettier --version验证有输出 - 查真实路径：
which prettier（macOS/Linux）或where prettier（Windows），结果类似/usr/local/bin/prettier或C:\Users\Alice\AppData\Roaming\npm\prettier.cmd - 打开 Preferences → Package Settings → JsPrettier → Settings – User，粘贴以下内容（注意替换路径）：
{
"prettier_cli_path": "/usr/local/bin/prettier",
"auto_format_on_save": true,
"auto_format_on_save_extensions": ["js", "jsx", "ts", "tsx", "json", "vue"],
"auto_format_on_save_excludes": ["*/node_modules/*", "*/dist/*"]
}
漏写 "auto_format_on_save": true、路径填成 "prettier" 或留空、扩展名没加 ts 却想格式化 TypeScript 文件——这三类错误占失效案例的 80% 以上。
Python 文件该用 autopep8 还是 black
二者行为差异极大，不能共存；选错会导致保存后缩进错乱、引号翻转、甚至触发 reindent failed 错误。
-
autopep8：保守，只修 PEP 8 明确规定的空格、换行、括号位置；适合老项目过渡。安装后配插件AutoPEP8，并在用户设置中加"auto_format_on_save": true -
black：激进，不接受配置，直接重写 AST；必须用插件SublimeBlack，且pipx install black比pip install black更干净 - 若项目用
pyproject.toml配置[tool.black]，Sublime 插件默认不读，得在SublimeBlack设置里显式加"black_args": ["--config", "pyproject.toml"] - 别同时启用
AutoPEP8和SublimeBlack：它们都监听on_post_save_async，但只有一个能抢到执行权，另一方会彻底静默失联
为什么保存后没反应？PATH 和启动方式是最大陷阱
90% 的“不工作”问题，不是插件没装对，而是 Sublime 的运行环境根本找不到你终端里能跑的命令。
- macOS/Linux：Sublime 从 Dock 启动时，不加载
~/.zshrc或~/.bash_profile里的$PATH；可在 Preferences → Settings – User 里加一行："path": "/usr/local/bin:/opt/homebrew/bin"（填你实际装prettier或black的路径） - Windows：确认
npm install -g prettier后，把类似C:\Users\XXX\AppData\Roaming\npm加进系统环境变量，再重启 Sublime - 验证方式：在 Sublime 控制台（
Ctrl+`）输入import subprocess; subprocess.run(['prettier', '--version'])，看是否返回版本号 - 注意：
format_on_save只对「已保存的文件」生效，新建未命名的 tab（untitled）不会触发
多个格式化插件共存会互相屏蔽
同时启用 JsPrettier 和 AutoPEP8，或 JsPrettier 和 SublimeLinter-eslint，容易出现「某类文件突然不格式化」——因为它们都监听 on_post_save_async，但只有一个能抢到执行权，且无冲突提示。
格式化依赖语法 scope 而非单纯后缀；比如 .vue 文件里 JS 块没被识别成 source.js scope，就不会走 JsPrettier 流程。别碰已停止维护的 HTML-CSS-JS Prettify，它在 ST4 下大概率触发 UnicodeDecodeError 或直接无响应。
