Sublime Text 原生不支持保存自动格式化，必须安装并手动启用第三方插件；JsPrettier（需全局或项目级 prettier）、AutoPEP8（需 pip 安装）是主流选择，配置需注意文件类型识别、路径设置及排除目录。
Sublime 必须装插件才能保存自动格式化
原生 Sublime Text 不支持“保存即格式化”，editor.formatOnSave 这类 VSCode 风格的开关根本不存在。所有自动格式化能力都来自第三方插件，且必须手动开启——插件安装完默认是关闭的。
- 别信“装完就生效”的说法，90% 的人卡在这一步
- 禁用已停止维护的
HTML-CSS-JS Prettify：它在 Sublime Text 4 下大概率抛UnicodeDecodeError或直接无响应 - JS/TS/JSON 推荐
JsPrettier；Python 项目用AutoPEP8；通用需求可选Sublime-CodeFormatter（但配置更复杂） - 别同时装多个格式化插件——它们都监听
on_post_save_async，会互相覆盖或静默失效
JsPrettier：JS 文件保存自动格式化的实操配置
JsPrettier 不是独立工具，它只是调用本地 prettier CLI。没装 prettier，插件就只是个空壳。
- 先全局安装：
npm install -g prettier（或yarn global add prettier） - 路径要配对：如果用
pnpm或项目级prettier，把prettier_cli_path改成"./node_modules/.bin/prettier"，注意这是相对于当前文件路径，不是项目根目录 - 用户配置路径：
Preferences → Package Settings → JsPrettier → Settings – User - 关键配置项（必须写全）：
{ "auto_format_on_save": true, "auto_format_on_save_excludes": ["*/node_modules/*", "*/dist/*"], "auto_format_on_save_extensions": ["js", "jsx", "ts", "tsx", "json"] } -
auto_format_on_save_excludes强烈建议加上——否则一保存node_modules/react/index.js，Sublime 可能直接卡死
AutoPEP8：Python 文件怎么和 VSCode 的 Black 体验接近？
AutoPEP8 行为比 black 保守，默认不改缩进、不强制单引号、不重排 import，但它稳定、轻量、兼容 ST4。
- 先确保系统有
autopep8命令：pip install autopep8 - 插件配置里加这行：
"auto_format_on_save": true，其他参数非必需 - 想接近
black效果？加参数："args": ["--in-place", "--aggressive", "--max-line-length=88"] - 注意：
AutoPEP8不读取项目根目录的.pycodestyle或setup.cfg，规则得硬写进插件配置 - 如果文件被识别成
Plain Text而不是Python（右下角语言显示不对），AutoPEP8完全不触发——先按Ctrl+Shift+P→Set Syntax: Python
为什么保存后没反应？常见断点排查
格式化没发生，90% 是因为“插件没认出文件类型”或“命令根本没跑起来”，而不是配置写错了。
- 检查右下角语言标识：必须是
JavaScript，不是Vue Component；是Python，不是Plain Text。否则插件压根不介入 -
.vue文件里的<script>默认不走JsPrettier，需额外装Vue Syntax Highlight并确认 script 块被识别为 JS - 插件日志藏在 Sublime 控制台（
Ctrl+`）：保存后看有没有JsPrettier: Starting...或报错路径找不到 - ST4 对插件兼容性敏感：某些老版本
JsPrettier在 ST4 下需手动升级到 v5.0+，否则on_post_save_async不触发
最麻烦的其实是路径和上下文——prettier_cli_path 是绝对路径还是相对路径，取决于你用全局安装还是项目局部 bin，而 Sublime 插件不会帮你猜。
