Sublime Text保存时自动格式化需手动配置prettier_cli_path为完整可执行路径、显式开启auto_format_on_save，且因GUI启动时PATH不可见，90%失败源于环境不一致；须用which/where查真实路径、避免插件共存冲突、确保文件已保存并匹配语法类型。
Sublime Text 保存时自动格式化不是装个插件就完事，关键在 prettier_cli_path 必须填对、auto_format_on_save 必须显式开启，且 Sublime 的运行环境 PATH 和你终端里的不一致——这是 90% 失败的根源。
prettier_cli_path 不填或填错，auto_format_on_save 就是摆设
JsPrettier 默认不会自动发现全局安装的 prettier，尤其 macOS/Linux 从 Dock 启动、Windows 用桌面图标打开时，根本看不到 shell 的 PATH。它找不到命令，也不报错，只是静默跳过。
- 查真实路径别猜：macOS/Linux 运行
which prettier，结果类似/opt/homebrew/bin/prettier；Windows 运行where prettier，结果类似C:UsersAliceAppDataRoaming pmprettier.cmd - 填进配置必须是完整可执行路径，不能只写
"prettier_cli_path": "prettier"或留空 - 路径含空格或中文？必须加双引号，Windows 反斜杠要写成双反斜杠（
"C:\Users\Alice\AppData\Roaming\npm\prettier.cmd"）或统一用正斜杠（"C:/Users/Alice/AppData/Roaming/npm/prettier.cmd"）
auto_format_on_save 默认是 false，不手动开等于没装
所有主流格式化插件（JsPrettier、AutoPEP8、Black Formatter）默认都关闭保存触发，这是防误改的设计，不是 bug。
- 打开菜单 → Preferences → Package Settings → JsPrettier → Settings – User
- 只在右侧用户配置里加这几行（不要覆盖整个文件）：
{ "auto_format_on_save": true, "auto_format_on_save_extensions": ["js", "ts", "jsx", "tsx", "json", "vue"] } -
auto_format_on_save_extensions不填，就只对默认的.js生效；漏掉ts，TypeScript 文件就不会被格式化
多个格式化插件共存会互相屏蔽
JsPrettier 和 AutoPEP8、SublimeLinter-eslint、Sublime-Code-Formatter 都监听 on_post_save_async，但 Sublime 只让其中一个插件抢到执行权，没有冲突提示，现象就是“某类文件突然不格式化”。
- 前端项目只留 JsPrettier，Python 项目只留 Black Formatter 或 AutoPEP8
- 如果要用通用型插件（如 Sublime-Code-Formatter），就别再装 JsPrettier —— 它们底层调用的是同一个
prettierCLI，重复注册钩子反而增加失败概率 - 验证是否生效：保存前在 Sublime 控制台（
Ctrl+`）里输入import subprocess; subprocess.run(['prettier', '--version'])，看能否返回版本号
格式化只对已保存的文件生效，untitled tab 和语法类型不匹配的文件会被跳过
Sublime 的保存格式化机制有隐含前提：文件必须已有路径（即已保存过）、当前视图的 syntax 必须被插件识别为支持类型（比如 JavaScript，而不是 Plain Text）。
- 新建未命名 tab（标题是
untitled）不会触发任何格式化，哪怕你写了 JS 代码 - 右下角语法标识要是
JavaScript，不是JSX或Vue Component？JsPrettier 默认不处理 —— 得在auto_format_on_save_extensions里补上对应后缀，或手动切换 syntax - 大文件（比如 >1MB 的 JSON）可能超时，可在配置里加
"auto_format_on_save_timeout_ms": 2000
最常被忽略的是：Sublime 启动方式决定它能不能看到你的 PATH。终端里 prettier --version 能跑，不代表插件能调用成功 —— 一定要用终端启动 subl 来验证，或者把 npm bin 路径硬编码进插件配置里。
