Sublime Text 中“HTMLBeautify”插件已停更、不兼容ST4且命令不可用；应改用持续维护的 JsPrettier（需Node.js+prettier）或 HTML-CSS-JS Prettify（零依赖但须正确配置node_path）。
Sublime Text 本身不支持 HTML 一键美化，必须装插件；但“HTMLBeautify”这个插件名是陷阱——它早已停止维护、不兼容 Sublime Text 4，且命令不可用。
为什么搜 HTMLBeautify 会踩坑
Package Control 里搜 HTMLBeautify 会出现多个同名或近似名插件（如 Sublime-Beautify、HTML-Beautify），但它们：
- 最后更新时间多在 2018–2020 年，无法处理现代 HTML5 语义标签、自闭合 SVG 标签或 JSX 片段
- 不识别 Sublime Text 4 的新 API，安装后 Ctrl+Shift+P 输入 Beautify 根本不显示命令
- 配置项硬编码缩进为 4 空格，无法覆盖，也不支持 wrap_line_length 或属性换行控制
真正能用的替代方案只有两个
目前稳定、持续维护、适配 Sublime Text 4 的插件就两个，选哪个取决于你是否已有 Node.js 环境：
- 如果已装
Node.js且全局有prettier（prettier --version能返回版本号）→ 用JsPrettier：它调用本地prettierCLI，支持最新 HTML/JSX/TS 语法，配置灵活，错误提示明确 - 如果不想装 Node.js，只处理纯 HTML/CSS/JS（无 JSX、无 ES2024 新特性）→ 用
HTML-CSS-JS Prettify：轻量、零依赖，但必须手动确认node_path配置（Windows 用户常卡在这一步）
HTML-CSS-JS Prettify 安装后没反应？先查这三处
常见报错是 prettier failed: command not found 或直接无响应，本质不是插件问题，而是路径没对上：
- 打开
Preferences → Package Settings → HTML-CSS-JS Prettify → Settings - User，检查"node_path"是否指向真实node.exe（Windows）或node（macOS/Linux）；默认配置里的路径是示例，不是自动检测的 - 确保文件语法识别正确：右下角状态栏应显示
HTML，不是Plain text或Text；点一下切换，否则插件不触发 - 首次使用建议关闭所有文件再重启 Sublime，避免旧缓存导致
htmlprettify命令未注册
快捷键和自动保存别盲目开
HTML-CSS-JS Prettify 默认快捷键是 Ctrl+Shift+H（Win/Linux）或 Cmd+Shift+H（macOS），但要注意：
立即学习“前端免费学习笔记（深入）”；
-
"format_on_save": true开启后，仅对当前语法类型生效（比如设了只对source.html生效，CSS 文件不会自动格式化） - 不要在中文输入法激活状态下按快捷键——
Ctrl+Shift+H在部分输入法中会被拦截为“切换输入模式”，改用Ctrl+Alt+F更稳 - 如果格式化后引号变成单引号、属性顺序乱了，不是插件 bug，而是你没覆盖默认配置；在
Settings - User里加"html_quote_style": "double"和"html_wrap_attributes": "force-aligned"
最常被忽略的其实是语法识别和 node_path 的耦合性：插件能运行 ≠ 能正确调用 node，而 node 可用 ≠ 路径被 Sublime 读到。这两层漏掉一层，Ctrl+Shift+H 就只是按了个寂寞。
