Sublime保存时自动格式化依赖插件监听on_post_save事件并调用本地CLI工具（如prettier、black）。常见失败原因：未安装CLI、路径错误、插件未启用自动触发。推荐JsPrettier（JS/TS/Vue/JSON）或SublimeOnSaveBuild+自定义.sublime-build（多语言）。
Sublime 保存时自动格式化，本质是“插件 + CLI 工具 + on_save 绑定”三者联动
Sublime Text 本身不带格式化能力，所谓“自动保存美化”，其实是靠插件监听 on_post_save 事件，再调用你本地装好的 CLI 工具（如 prettier、black、autopep8）来完成的。没装 CLI、路径填错、插件没启用自动触发——这三类问题占了 90% 的失败案例。
推荐 JsPrettier：轻量、稳定、开箱即用（尤其适合 JS/TS/Vue/JSON）
它比老牌的 Prettier 插件维护更活跃，配置也更直白。但注意：它不处理 Python 或 CSS 单独场景，别硬套。
- 先确保终端能跑通：
prettier --version；不行就npm install -g prettier - 用
Ctrl+Shift+P→Package Control: Install Package→ 搜JsPrettier安装 - 进
Preferences → Package Settings → JsPrettier → Settings，贴入：
{
"auto_format_on_save": true,
"custom_file_extensions": ["js", "jsx", "ts", "tsx", "json", "vue", "mdx"],
"prettier_cli_path": "/usr/local/bin/prettier"
}
⚠️ Windows 用户必须填对 prettier_cli_path，比如 C:\\Users\\YourName\\AppData\\Roaming\\npm\\prettier.cmd；不确定？终端运行 where prettier 查。
通用方案：SublimeOnSaveBuild + 自定义 .sublime-build（适合多语言混合项目）
如果你同时写 JS、Python、CSS，又不想装一堆插件，这个组合更灵活——它不绑定具体格式器，只负责“保存时执行命令”。
- 安装
SublimeOnSaveBuild插件 - 新建构建系统：
Tools → Build System → New Build System…，填入：
{
"cmd": ["prettier", "--write", "$file"],
"selector": "source.js, source.jsx",
"shell": true,
"working_dir": "$file_path"
}
保存为 Prettier.sublime-build（文件名必须一致）
- 进
Preferences → Package Settings → SublimeOnSaveBuild → Settings，写：
{ "commands": ["Prettier"] }
同理可建 Black.sublime-build 处理 Python，只要 pip install black 装好就行。
常见失效原因和快速验证法
格式化没反应？别猜，按顺序查这四点：
- 终端里直接运行
prettier --write test.js是否成功？失败说明 CLI 环境没配好 - Sublime 状态栏右下角显示的语法类型，是否匹配你构建系统里的
selector？比如写的是 JS，但状态栏显示 “Plain Text”，那肯定不触发 - 插件设置里有没有拼错键名？比如把
auto_format_on_save写成format_on_save—— JsPrettier 不认后者 - 打开
View → Show Console，保存文件时看有没有报File not found: prettier类错误，有就是路径问题
最易被忽略的是：CLI 工具装在 Node 的 nvm 环境或虚拟环境中，而 Sublime 启动时没加载对应 shell profile，导致它根本找不到 prettier 命令——这种得改 prettier_cli_path 为绝对路径，不能依赖 $PATH。
