htmlbeautify插件需node.js及全局安装js-beautify，配置html_beautify_path路径，并确保html语法合法；否则命令不可用、格式化失败或输出空白。
HTMLBeautify 在 Sublime Text 里不能直接用——它依赖 Node.js 运行，且默认配置容易崩，不装对依赖或配错路径，html-beautify 命令根本不会出现在命令面板里。
确认 Node.js 和 html-beautify CLI 已全局安装
HTMLBeautify 插件本质是调用命令行工具 html-beautify，不是纯 Python 实现。如果本地没装 Node.js 或没全局装 CLI，插件会静默失败。
- 终端执行
node -v和npm -v确认 Node.js 可用（推荐 v16+） - 运行
npm install -g js-beautify（注意包名是js-beautify，不是html-beautify；后者早已废弃） - 再执行
html-beautify --version，能输出版本号才算装对 - 如果提示 command not found，检查
npm bin -g输出的路径是否在系统$PATH中
Sublime Text 插件配置必须指定正确的 html-beautify 路径
插件默认找 html-beautify，但 macOS/Linux 和 Windows 下实际可执行文件名、路径可能不同，不手动指定就找不到命令。
- 打开 Sublime Text → Preferences → Package Settings → HTMLBeautify → Settings
- 在用户设置里补全
html_beautify_path，例如：
{
"html_beautify_path": "/usr/local/bin/html-beautify"
}
macOS 使用 Homebrew 安装 Node 的，路径通常是 /usr/local/bin/html-beautify；Windows 用户要写类似 C:\Users\xxx\AppData\Roaming\npm\html-beautify.cmd 的完整路径；WSL 用户注意路径指向的是 Windows 还是 Linux 环境下的二进制。
格式化时遇到“no output”或空白结果，大概率是语法错误或配置冲突
HTMLBeautify 对非法 HTML 极其敏感：未闭合标签、错位 script 标签、内联 JS 中的 { 或 // 都可能导致整个文档被清空或只返回前几行。
- 先用浏览器开发者工具验证 HTML 是否能正常解析（右键 → “查看页面源代码”再粘贴到在线校验器）
- 临时删掉
<script></script>块或注释掉可疑 JS，看是否能格式化成功 - 检查插件设置中是否启用了
"end_with_newline": true之类非默认项，某些组合会触发 js-beautify 的旧版 bug - 避免和
SublimeCodeIntel或Emment同时启用自动格式化，它们可能抢在 HTMLBeautify 前截断输入流
真正卡住的地方往往不是插件本身，而是 Node 环境路径没对上，或者 HTML 里混了前端框架模板语法（比如 {{ variable }}），而 js-beautify 默认并不认识这些——这种时候得关掉 indent_inner_html 或改用 prettydiff 类替代方案。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
