Sublime Text 本身不提供一键美化混乱标签结构的原生能力，必须依赖 HTML-CSS-JS Prettify 插件，该插件基于 js-beautify 解析 DOM，支持正确处理自闭合标签、缩进、空行等，但需满足编码为无 BOM UTF-8、右下角语法识别为 HTML、文档结构完整等前提条件。
Sublime Text 本身不提供“一键美化混乱标签结构”的原生能力，所谓一键，本质是插件在满足特定前提下触发的自动重排。装错插件、语法识别不对、编码带 BOM，都会让快捷键失效或格式化出错——不是操作问题，是前置条件没到位。
怎么选对插件：HTML-CSS-JS Prettify 是 HTML 的唯一靠谱选择
HTML 标签结构混乱（比如嵌套错位、缩进全无、属性挤成一行），必须用真正解析 DOM 的插件，而不是只加换行的“假美化”工具：
- 只装
HTML-CSS-JS Prettify，别碰HTML Formatter或Pretty HTML这类名字相似但无解析能力的插件 - 它基于 js-beautify，能识别
<div>和<img />的语义差异，不会把自闭合标签错误展开 - 安装后必须重启 Sublime，否则命令面板搜不到
HTML: Prettify - 右下角状态栏必须显示 HTML（不是 Plain text 或 PHP），否则插件拒绝执行
为什么 Ctrl+Shift+P → “Pretty HTML” 没反应
这不是快捷键坏了，而是三个硬性条件中至少一个没满足：
- 文件编码不是无 BOM 的 UTF-8：菜单
File → Reopen with Encoding → UTF-8，再Save with Encoding → UTF-8 - 文档里有未转义的
&，比如price=10&20，会直接报Parse Error，得先替换成& - 根节点缺失或标签未闭合（如漏了
</body>），插件会静默失败，不提示也不格式化 - 光标落在字符串内部（如
"class": "foo|bar"的竖线位置），HTML: Prettify会跳过整个文档
缩进错乱、注释移位、CDATA 被破坏怎么办
HTML-CSS-JS Prettify 默认行为不可关闭，但可通过配置收敛偏差：
- 缩进大小写成数字：
"indent_size": 2，写成"2"（字符串）就无效 - 保留空行需设
"preserve_newlines": true，否则连续空行会被压缩为一个 - 注释和
<!-- ... -->位置偏移是插件默认策略，无法禁用；<![CDATA[...]]>内容会被原样保留，但包裹它的换行可能被重排 - 属性不会自动排序，长属性也不会折行——这是设计如此，不是 bug
大文件卡死、中文变问号、DOCTYPE 消失的临界点
插件是一次性加载全文本解析，不是流式处理：
- 超过 500KB 的 HTML 文件，
HTML-CSS-JS Prettify就可能卡顿 5 秒以上，甚至触发 Sublime “无响应”警告 - 中文乱码基本等于编码没切对，确认右下角显示
UTF-8，且没带 BOM -
<!DOCTYPE html>在格式化后消失？说明原始文档开头有隐藏字符（如\ufeff），用十六进制编辑器查一下 - 真要处理大文件或强控 DOCTYPE/注释位置，该切到命令行工具：
prettier --parser html或tidy -i -m
真正麻烦的从来不是“怎么按快捷键”，而是格式化前那几秒检查：编码对不对、语法有没有硬伤、状态栏是不是 HTML——漏掉任意一项，后面所有操作都只是徒劳。
