装错插件是格式化失效的第一原因，必须安装html-css-js prettify并正确配置node.js路径、语法识别和快捷键，否则会静默失效。
装错插件是格式化失效的第一原因
别搜“Beautify”——Package Control 里名字带这个词的插件有十几个，90% 已停更、不兼容 Sublime Text 4，或只处理单一语言。真正能稳定覆盖 HTML/CSS/JS 三端的只有 HTML-CSS-JS Prettify。
安装路径必须严格：Ctrl+Shift+P → 输入 Package Control: Install Package → 搜索并选中 HTML-CSS-JS Prettify（注意连字符和大小写，不能少字母、不能空格）。
- 已装过
Sublime-Beautify或CodeFormatter？建议卸载——它们的命令名和html_css_js_prettify冲突，快捷键会互相覆盖 - 装完别直接试：关掉所有文件，完全退出 Sublime 再重开，否则命令可能未注册，Ctrl+Shift+P 里搜不到
- Mac 用户注意：
Cmd+Shift+H是默认快捷键，不是Ctrl；Windows/Linux 是Ctrl+Shift+H，但该组合在 ST 里原义是“打开控制台”，极易被覆盖
Node.js 配不对其它全是白忙
HTML-CSS-JS Prettify 不是纯 Python 插件，它底层调用 js-beautify CLI，必须依赖系统已安装的 Node.js。没装、或装了但路径不对，插件会静默失效——按快捷键没反应、命令面板搜不到、状态栏闪一下 Beautify failed 都是典型迹象。
验证方式：终端运行 node -v 和 npm -v，必须有版本号输出。若无：
- Windows 用 Scoop/Chocolatey 安装的，路径常不是
C:\Program Files\nodejs\node.exe，得手动配node_path - macOS/Linux 用
nvm的，which node输出路径需和 Sublime 内部环境一致；可在控制台（Ctrl+`）执行import os; print(os.environ.get('PATH'))对照 - 路径不一致？进 Preferences > Package Settings > HTML-CSS-JS Prettify > Settings – User，加一行：
"node_path": "/usr/local/bin/node"（替换成你的真实路径）
格式化没反应？先看右下角语法标识
插件只对明确识别为 HTML、CSS 或 JavaScript 的文件生效。右下角显示 Plain Text 或 Text，就直接跳过——这是第二大静默杀手。
- 手动设置语法：右键编辑器空白处 →
Set Syntax→ 选对应语言；尤其对.wxss、.vue、.astro等非标后缀，必须手动指定 - 快捷键冲突？进 Preferences > Key Bindings – User，删掉旧绑定，加一条干净的：
{"keys": ["ctrl+alt+h"], "command": "html_css_js_prettify"} - 配置里
"file_extensions"默认不含.astro等新后缀，需手动补全，否则即使设了语法也无效
缩进和折行效果差？只调这两个参数就够了
别一上来就折腾复杂 formatter 配置。影响观感最直接的是缩进宽度和单行长度：
-
"indent_size"：设为数字2或4，别写字符串"2"，否则报错 -
"wrap_line_length"：设为120可防止 HTML 标签被强行断行；设太小（如80）会导致style="..."这类内联样式乱拆 - 改完配置不用重启，但需确保当前文件语法正确，再试快捷键
真正容易被忽略的点：插件对 <script>const a = `html ${b}`</script> 这类混合内容容易误解析，建议把内联脚本/样式抽成单独文件再格式化。
