Sublime Text 原生不支持 HTML 格式化，需安装 JSBeautify 等插件；常见问题包括语法识别错误、选区限制、快捷键冲突及模板语法兼容性差，需调整配置或改用 JsPrettier。

Sublime Text 原生不支持 HTML 格式化，必须装插件

按 Ctrl+Shift+P 搜 Format HTML 什么都不会出来——这不是你操作错，是 Sublime 真的没这个功能。它不像 VS Code 那样开箱即用，所有格式化能力都得靠插件补。

• 最稳的选择是 JSBeautify：纯 Python 实现，不依赖 Node.js，装完就能用，支持 HTML/CSS/JS/JSON
• HTML-CSS-JS Prettify 也常用，但它底层调用 prettier 或 js-beautify CLI，必须装 Node.js，且 Sublime 4 下容易因 Python 版本冲突报 UnicodeDecodeError
• 别试 Emmet 或 SublimeCodeIntel，它们不处理缩进、换行、属性排布，不是格式化工具

快捷键没反应？先查三件事

很多人装完插件按 Ctrl+Shift+H 或 Ctrl+Alt+F 没反应，基本卡在这几个点上：

• 右下角语法识别错了：显示的是 Plain Text 或 JavaScript，不是 HTML —— 点一下切换过去再试
• 光标在选中文本里：JSBeautify 默认只格式化选区；想全文件格式化，得先 Ctrl+A 全选，或确保没选中任何内容
• 快捷键被占用了：比如输入法、系统全局热键（尤其 Ctrl+Alt+F 常被 Linux 终端捕获），去 Preferences → Key Bindings 查有没有重复的 js_beautify 或 html_css_js_prettify 条目

格式化后标签乱、属性挤成一行？改配置

默认的 js-beautify 配置对现代 HTML 友好度一般：长标签属性全塞一行，<div> 和 <p> 嵌套缩进失效，空行还可能失控。

• 打开 Preferences → Package Settings → JSBeautify → Settings
• 在 "html" 块里加这几项：

  {
    "wrap_line_length": 120,
    "end_with_newline": true,
    "indent_inner_html": true,
    "preserve_newlines": false
  }

• 删掉或注释掉 "preserve_newlines"：它会让模板语法（如 Vue 的 {{ item }}）周围空行爆炸，尤其在混合脚本块里

混了模板语法或自定义标签就崩？换策略

只要 HTML 里出现 {{ user.name }}、<my-component></my-component>、{% if %} 这类非标准结构，JSBeautify 就会当非法标签报错，停在第一处，整段不格式化。

立即学习“前端免费学习笔记（深入）”；

• 临时解法：把模板部分用 <!-- html-beautify: ignore --> 包起来（需插件支持 ignore 注释）
• 长期方案：用 JsPrettier + 项目级 .prettierrc，它对 JSX/Vue/Svelte 更友好，但要提前装好 npm install -g prettier，并确认 which prettier 能返回路径
• 注意 selector 配置：Build System 里写 "selector": "source.html"，不是 text.html.basic，否则命令压根不触发

插件能跑通只是第一步，真正卡住人的永远是语法识别、上下文作用域和模板边界——这些地方没显式报错，但格式化就是“看起来怪怪的”。