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,而是 缓解方式有限,但可尝试: 真正难搞的是嵌套 别指望一键还原手写 HTML 的“个性缩进”。它本质是代码格式化工具,不是样式美化器。prettier 默认策略所致。例如:wrap_line_length。这是 prettier 对“可读性”的主观判断。
"htmlWhitespaceSensitivity": "ignore"(仅影响空格处理)"printWidth": 999(不推荐,会影响 JS/CSS)js-beautify 引擎(需在配置中设 "use_prettier": false,但会失去 Vue/JSX 支持) 或含 Liquid/JSX 表达式的 HTML —— 此时没有银弹,要么接受 prettier 的风格,要么切到专用编辑器(如 VS Code + Prettier 扩展)做混合工作流。











