Sublime Text 本身不格式化代码，所有“一键美化”均依赖插件，且必须满足底层命令可用、语法识别正确、配置无误三个前提；常见失效原因包括状态栏未设对语言、插件未加载成功、Node.js或CLI路径错误，不同语言应选用HTML-CSS-JS Prettify、JsPrettifier、sublime_black、SQLBeautifier、XML Tools等经验证稳定插件。
Sublime Text 本身不格式化代码，所有“一键美化”“保存即排版”都依赖插件，且必须满足底层命令可用、语法识别正确、配置无误三个前提——缺一不可。
为什么装了插件却按快捷键没反应
这不是插件坏了，而是 Sublime 在静默失败。常见卡点有三个：
- 右下角状态栏显示的是
Plain Text而不是HTML、CSS、JavaScript或XML—— 插件只对明确识别的语法生效，点一下状态栏手动选对语言 -
html_css_js_prettify或js_prettier命令在Ctrl+Shift+P里搜不到？说明插件没加载成功，重启 Sublime 或执行Package Control: Satisfy Dependencies - 状态栏左下角偶尔闪一下
Beautify failed却不留痕迹？大概率是 Node.js 没装、prettierCLI 不在$PATH、或 XML 文件带 BOM / 未闭合标签
不同语言该用哪个插件才靠谱
别信名字带 “Beautify” 的通用插件，它们大多已停更或只兼容老版本。当前稳定组合如下：
-
HTML/CSS/JS：用
HTML-CSS-JS Prettify—— 轻量、无需额外 CLI、配置少，Ctrl+Shift+H默认可用 -
JavaScript/TS/JSON：用
JsPrettier—— 必须提前装好npm install -g prettier，它读.prettierrc，但不认.editorconfig -
Python：用
sublime_black（不是AutoPEP8）—— 后者在 Python 3.12+ 对match语句直接报错 -
SQL：用
SQLBeautifier—— 支持关键字大写、缩进风格切换，纯本地运行，不连数据库 -
XML：只认
XML Tools—— 其他插件会把<tag attr="v">当 HTML 处理，可能错误闭合自闭合标签
保存时自动格式化怎么配才不翻车
别手写复杂键绑定，优先用插件自带开关：
-
HTML-CSS-JS Prettify→Preferences → Package Settings → HTML-CSS-JS Prettify → Enable Autoformat on Save，勾上即可 -
JsPrettier不提供保存触发，得靠外部工具（如subl --command "js_prettier"配合文件监听），不推荐普通用户折腾 - 如果非要自定义快捷键（比如想让
Ctrl+S同时保存 + 美化），务必加context限定语法类型，否则 JS 文件按Ctrl+S可能触发 Python 格式化器 - 多个插件共存时，快捷键冲突高发——建议按语言区分：
Ctrl+Alt+H给 HTML，Ctrl+Alt+J给 JS，Ctrl+Alt+P给 Python
配置改哪里才真正生效
插件行为由两层控制：插件默认规则 + 你写的配置。但很多配置项根本不会被读取：
-
HTML-CSS-JS Prettify只读自己的Set Prettify Preferences – User，里面改"indent_size": 2和"wrap_line_length": 120最有效 -
JsPrettier优先读项目根目录下的.prettierrc，但不会读.editorconfig；验证方式：终端跑prettier --write your-file.js，结果一致才说明 Sublime 插件生效 -
XML Tools不支持项目级配置，所有设置都在Preferences → Package Settings → XMLTools → Settings – User，只改"indentation_size"和"preserve_whitespace"，其他字段新版已废弃 - 所有 JSON 配置里，数字不能写成字符串（
"indent_size": "2"会静默失败），逗号多一个、括号少一个，整个配置就失效
真正麻烦的从来不是“怎么装”，而是 Sublime 不报错、不提示、不弹窗——它只是安静地不工作。盯住状态栏左下角那一下闪过的 Beautify failed，才是唯一线索。
