jsprettier 保存自动格式化需正确配置 prettier_cli_path 和 auto_format_on_save。必须填入 which/where 查得的完整可执行路径，开启 auto_format_on_save 并设置对应扩展名，排除 node_modules 等目录，确保文件编码为 utf-8（无 bom）。
JsPrettier 保存自动格式化必须配 prettier_cli_path
不填或填错 prettier_cli_path，auto_format_on_save 就是摆设。Sublime 的运行环境和终端 PATH 经常不一致，插件找不到 prettier 命令时不会报错，只会静默跳过格式化。
查真实路径别猜：
- macOS/Linux：终端执行
which prettier，结果类似/usr/local/bin/prettier - Windows：命令行执行
where prettier，结果类似C:\Users\Alice\AppData\Roaming\npm\prettier.cmd（注意用双反斜杠或正斜杠） - 填进 JsPrettier 用户配置时，必须是完整可执行路径，不能只写
prettier
常见错误："prettier_cli_path": "prettier" 或留空 → 格式化完全不触发；路径含中文或空格未加引号 → 启动失败但无提示。
auto_format_on_save 开关默认是关闭的
装完 JsPrettier、Black、AutoPEP8 等插件后，auto_format_on_save 或 on_save 全部默认为 false。这不是 bug，是设计——防止插件未经确认就修改代码。
必须手动改用户配置：
- 菜单 → Preferences → Package Settings → JsPrettier → Settings
- 在右侧用户配置区域加入（不是覆盖整个文件）：
{
"auto_format_on_save": true,
"auto_format_on_save_extensions": ["js", "ts", "jsx", "tsx", "json", "vue"]
}
注意：auto_format_on_save_extensions 不填则只对默认扩展名生效（如 JsPrettier 默认只理 .js），漏写 .ts 就不会格式化 TypeScript 文件。
多个格式化插件共存会互相屏蔽
同时启用 JsPrettier 和 AutoPEP8，或 JsPrettier 和 SublimeLinter-eslint，容易出现「某类文件突然不格式化」——因为它们都监听 on_post_save_async，但只有一个能抢到执行权，且无冲突提示。
稳妥做法：
- 按语言边界划分：JS/TS/JSON 用 JsPrettier，Python 用 SublimeBlack（调
blackCLI），CSS/HTML 用 Prettier 插件统一接管 - 禁用所有其他格式化插件的
on_save开关，只留一个主插件开启 - 避免使用已停更的 HTML-CSS-JS Prettify：ST4 下大概率触发
UnicodeDecodeError或直接无响应
验证是否真生效：改一行 JS 代码，保存，看控制台（Ctrl+`）有没有 JsPrettier: formatting... 日志。
大文件、node_modules、编码异常会中断格式化
JsPrettier 默认对超大文件（>1MB）或 BOM 编码文件跳过处理，但不会告诉你原因。加上 auto_format_on_save_excludes 能提前规避风险：
{
"auto_format_on_save_excludes": [
"*/node_modules/*",
"*/dist/*",
"*/build/*",
"*/.git/*"
]
}
另外，如果项目里混用 CRLF/LF 或含 BOM 的 UTF-8 文件，prettier 可能解析失败，表现为保存后无变化、无报错、控制台也无日志——此时需检查文件编码（右下角状态栏），转成 UTF-8（无 BOM）再试。
真正卡住的地方往往不是配置开关，而是 CLI 工具本身能否被 Sublime 正确调起、输入流是否干净、排除规则是否漏写路径通配符。
