Sublime Text保存时自动排版需依赖插件调用外部CLI工具，常见失效原因包括未正确配置工具路径、未启用自动格式化开关、语法类型不匹配或PATH环境不一致。
Sublime Text 本身不支持保存时自动排版，所谓“自动排版”其实是靠插件调用外部 CLI 工具（如 prettier、black）完成的；没装对工具、路径填错、或语法类型不匹配，都会导致保存后毫无反应——而且通常不报错，只静默失效。
JsPrettier 配置 prettier_cli_path 和 auto_format_on_save
JsPrettier 是前端最稳的选择，但它不会自动找 prettier 命令，必须手动填绝对路径。终端能跑 prettier --version ≠ Sublime 能找到它。
- 先在终端运行
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"、扩展名没加"tsx"却想格式化 TSX 文件——这三类错误占失效案例八成以上 - Windows 用户装完 Node.js 后需重启 Sublime，否则 PATH 不生效
Python 用 Sublime-Code-Formatter + black 而不是 AutoPEP8
Sublime-Code-Formatter 支持多语言绑定，对 black 的兼容性比单独插件更可靠；AutoPEP8 和 SublimeBlack 不能共存，否则保存时可能只触发一个、另一个彻底失联。
- 确保已运行
pip install black --user，再用which black或where black查路径 - 打开
Preferences → Package Settings → Sublime Code Formatter → Settings – User，填入：
{
"code_formatting_engine": "black",
"format_on_save": true,
"format_on_save_timeout_ms": 3000,
"black_args": ["--config", "pyproject.toml"]
}
-
black_args必须显式加，否则插件不读pyproject.toml里的[tool.black] -
format_on_save_timeout_ms设为3000，避免大文件保存时被中断且不报错 - 别开
AutoPEP8插件的auto_format_on_save，二者监听同一事件，会互相覆盖
为什么保存后没反应？重点查这三点
90% 的“不工作”不是插件问题，而是环境错位。Sublime 启动方式决定它看到的 PATH —— 从桌面图标启动和从终端 subl . 启动，PATH 往往不同。
- 右下角状态栏必须显示正确语法类型（如
JavaScript、Python），不是Plain Text；点它手动切换 - 文件缩进必须统一：菜单
View → Indentation → Convert Indentation to Spaces，再选Indent Using Spaces -
trim_automatic_whitespace必须设为false，否则格式化后末尾空格会被悄悄删掉，干扰prettier的输出一致性
真正容易被忽略的是：Sublime 的 PATH 和你终端的 PATH 几乎总是不一致，而插件只认它自己看到的那个。验证方式很简单——打开控制台（Ctrl+`），保存文件，看有没有 prettier not found 或 black command not found 这类提示；没有提示也不代表成功，得看代码是否真变了。
