HtmlBeautify已弃用，应安装HTML-CSS-JS Prettify插件；需配合prettier CLI使用，支持自定义HTML格式化配置与快捷键绑定，Vue/Svelte需额外设置parser。
直接通过 Package Control 安装 HtmlBeautify
HtmlBeautify 不是 Sublime Text 内置插件，必须通过 Package Control 安装。如果你还没装 Package Control，先按 Ctrl+`（Windows/Linux）或 Cmd+`（macOS）调出控制台，粘贴官方安装脚本（注意：仅限最新稳定版 Sublime Text 4；Sublime Text 3 用户请确认已启用 HTTPS 支持）。
安装完 Package Control 后，按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Package Control: Install Package 回车，再搜索 HTML-CSS-JS Prettify ——别搜 “HtmlBeautify”，它早已被弃用并重定向至此插件。
- 旧名
HtmlBeautify已下架，强行搜不到或安装失败是正常现象 -
HTML-CSS-JS Prettify是当前唯一维护活跃、支持 Sublime Text 4 的替代方案 - 安装后无需重启，但首次使用前建议关闭再打开 HTML 文件，避免语法高亮未生效
配置 prettier 路径和 HTML 格式化选项
该插件默认依赖外部 prettier CLI 工具，不是纯 Python 实现。如果没装 prettier，会报错：prettier not found. Please install it first.
解决方式有两种：
立即学习“前端免费学习笔记（深入）”；
- 全局安装：
npm install -g prettier（确保prettier在系统PATH中） - 项目级安装：
npm install --save-dev prettier，然后在插件设置中指定prettier_cli_path为./node_modules/.bin/prettier
配置路径：菜单栏 → Preferences → Package Settings → HTML-CSS-JS Prettify → Set Configuration (Project) 或 Set Configuration (Syntax)。关键配置项包括：
"html": { "end_with_newline": true, "wrap_line_length": 120 }-
"indent_size": 2（影响缩进，不是tab_size） -
"unformatted": ["pre", "code", "textarea"]（防止代码块被意外换行）
快捷键冲突与手动触发格式化
默认快捷键 Ctrl+Shift+H（Windows/Linux）或 Cmd+Shift+H（macOS）可能被其他插件占用，比如 Emmet 或 SideBarEnhancements。如果按下无反应，先检查是否真触发了格式化（可观察状态栏是否有 Prettifying... 提示）。
推荐做法是显式绑定快捷键：
[
{
"keys": ["ctrl+alt+f"],
"command": "html_css_js_prettify",
"args": {"type": "html"}
}
]
保存到 Preferences → Key Bindings 的右侧（用户键位文件）。注意："type": "html" 必须明确指定，否则对 .html 文件可能误用 JS 规则。
- 只选中部分 HTML 片段时，插件默认只格式化选区 —— 这是预期行为，不是 bug
- 若整页没反应，检查当前视图的语法是否为
HTML（右下角显示，不是Plain Text或PHP） - Vue/Svelte 文件需额外配置
"vue": { "parser": "vue" }，否则 script/style 块可能错乱
常见错误：格式化后标签错位或属性换行异常
这不是插件 bug，而是 prettier 默认策略所致。例如：<div class="a b" id="x"> 可能被折成多行，即使没超 wrap_line_length。这是 prettier 对“可读性”的主观判断。
缓解方式有限，但可尝试：
- 禁用自动换行：
"htmlWhitespaceSensitivity": "ignore"（仅影响空格处理） - 强制单行属性：
"printWidth": 999（不推荐，会影响 JS/CSS） - 改用
js-beautify引擎（需在配置中设"use_prettier": false，但会失去 Vue/JSX 支持）
真正难搞的是嵌套 <template> 或含 Liquid/JSX 表达式的 HTML —— 此时没有银弹，要么接受 prettier 的风格，要么切到专用编辑器（如 VS Code + Prettier 扩展）做混合工作流。
别指望一键还原手写 HTML 的“个性缩进”。它本质是代码格式化工具，不是样式美化器。
