sublime text 保存时自动格式化需插件、本地cli工具和精确路径配置三者同时成立；jsprettier须手动配置prettier_cli_path绝对路径、开启auto_format_on_save、指定extensions，python推荐black或autopep8二选一且不可共存。
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），结果类似/opt/homebrew/bin/prettier或C:/Users/Alice/AppData/Roaming/npm/prettier.cmd - 打开 Preferences → Package Settings → JsPrettier → Settings – User，只在右侧用户配置里加这几行（不要覆盖整个文件）：
{
"prettier_cli_path": "/opt/homebrew/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 从 Dock 启动、Windows 用桌面图标打开时，Sublime 根本看不到 shell 的
PATH；解决办法是终端执行subl启动编辑器（确保它走的是你当前 shell 的 PATH） -
prettier_cli_path必须填完整可执行路径，不能只写"prettier"；Windows 路径含反斜杠，要写成双反斜杠（"C:\Users\Alice\AppData\Roaming\npm\prettier.cmd"）或统一用正斜杠（"C:/Users/Alice/AppData/Roaming/npm/prettier.cmd"） - 右下角语法类型没识别对：比如显示的是
JavaScript (Babel)而非JavaScript，JsPrettier 默认不拦截，需在配置中加"javascript (babel)": true - JsPrettier 默认跳过超过 1MB 的文件（防卡死），大 JSON 或日志文件会静默忽略
最易被忽略的点是：插件配置里的 auto_format_on_save 开关默认为 false，且 Sublime 的运行环境与终端 PATH 不一致——这两处不动，装再多插件也没用。
