Sublime Text 文件格式化失败的主因是语法未识别或配置错误：需先通过右下角设置正确语法，再配置插件的 node_path、indent_scripts 等参数，并确保 format_on_save 开关位于顶层；扩展名映射须匹配语法包且避免被 ApplySyntax 覆盖。
Sublime Text 里文件类型没识别对，格式化就根本不会触发——这不是插件坏了，是它压根没拿到“合法身份”。必须先让 Sublime 知道你打开的是什么语言，再让它知道该用什么规则去格式化。
右下角显示 Plain Text 就别急着按快捷键
格式化命令（比如 html_css_js_prettify 或 js_prettier）只响应已识别语法的视图。如果右下角写着 Plain Text，哪怕文件后缀是 .vue 或 .astro，插件也会跳过。
- 临时解决：点击右下角
Plain Text→ 选择对应语法，如Vue Component、HTML、JavaScript - 永久生效：选中后，再点菜单
View → Syntax → Open all with current extension as…，选目标语法 - 验证是否写入：该操作会在
Packages/User/下生成对应语法的.sublime-settings文件，内容含"extensions": ["vue"] - 别往全局
Preferences.sublime-settings里硬加extensions字段——Sublime Text 4 已废弃此写法，写了也不生效
HTML-CSS-JS Prettify 不工作？先查 node_path 和 indent_scripts
这个插件依赖系统 node 执行 js-beautify，不是装了 Node.js 就自动可用。常见静默失败原因就是路径不对或关键选项关着。
- 确认
node可被 Sublime 调用：终端运行which node（macOS/Linux）或where node（Windows），复制完整路径 - 填进插件设置：
Preferences → Package Settings → HTML-CSS-JS Prettify → Settings，写入："node_path": { "osx": "/usr/local/bin/node", "windows": "C:\Program Files\nodejs\node.exe", "linux": "/usr/local/bin/node" } -
<script>和<style>块不缩进？默认关闭。必须在配置里显式开启："html": { "indent_inner_html": true, "indent_scripts": true } - 改完保存，重启 Sublime；按
Ctrl+`打开控制台，执行import os; print(os.environ.get('PATH'))确认路径已加载
想保存时自动格式化，别碰全局 on_save_format
Sublime 原生没有 on_save_format 配置项，直接在用户设置里写这个字段完全无效。自动格式化必须靠插件自己提供的开关，且位置不能错。
- 对
HTML-CSS-JS Prettify：开关叫"format_on_save": true，必须写在插件主配置顶层，**不能**放在"html"或"js"子对象里 - 对
JsPrettier：开关是"format_on_save_enabled": true，同时确保"prettier_cli_path"指向本地或全局安装的prettierCLI（如node_modules/.bin/prettier） - 文件扩展名匹配失败？插件只看当前视图的
syntax（右下角）和配置里的file_extensions，两者都满足才触发。比如.svelte默认不在列表里，得手动加到"html": { "file_extensions": ["html", "svelte"] }
自定义语法关联比想象中更脆弱
手动加 "extensions": { "myext": "Packages/Python/Python.sublime-syntax" } 看似简单，但实际容易被覆盖或忽略。
- 优先级顺序：插件（如 ApplySyntax）> 当前窗口手动设置 > 用户
Settings中的extensions映射 > 默认语法包内置规则 - 如果装了
ApplySyntax，它会接管所有匹配逻辑，此时用户设置里的extensions完全不生效 - 路径写错一个字符（比如
Python.sublime-syntax写成Python.tmLanguage）就会回退到Plain Text，且无报错提示 - 小众语法包（如
Astro、Svelte）需单独安装，仅靠扩展名映射无法激活高亮和格式化能力
真正卡住人的从来不是“怎么配”，而是“为什么配了还不动”——往往差在 node_path 没填对、syntax 没切准、或者开关藏在子配置里没翻到。每个环节都得单独验证，少一步，格式化就停在半路。
