Sublime Text本身不提供自动排版能力，所谓“无法自动排版”90%是插件调用链中断：prettier/black未被真正调起；常见原因包括语法类型不匹配、CLI路径未填绝对路径、format_on_save_extensions未精确配置、环境变量不一致或文件语法非法。
Sublime Text 本身不提供自动排版能力，所谓“无法自动排版”，90% 是插件调用链在某个环节断了——不是你配错了，是 prettier、black 或 js_prettier 根本没被真正调起来。
为什么按 Ctrl+Alt+L / Ctrl+Shift+H 没反应
这不是快捷键失效，而是命令压根没走到执行阶段。常见静默卡点：
- 右下角状态栏显示的是
Plain Text或HTML，但你在格式化 JS ——js_prettier默认只响应source.js、source.ts等 selector，点一下状态栏手动切到JavaScript -
Ctrl+Shift+P里搜不到js_prettier或black命令？说明插件没加载成功，重启 Sublime 或执行Package Control: Satisfy Dependencies - Windows 用户装完 Node.js 后没重启 Sublime，
prettier.cmd路径进不了 Sublime 的环境变量，终端能跑，Sublime 控制台里import subprocess; subprocess.run(['prettier', '--version'])就报错 - 快捷键被其他插件劫持：比如
Emmet占用了Ctrl+Shift+H，打开Preferences → Key Bindings查右侧用户配置，确认没有重复绑定
format_on_save 开关开了却没触发
这个选项极度依赖三个显式条件，缺一不可：
-
format_on_save_extensions必须精确匹配扩展名：["js", "ts"]不会处理.tsx文件，Vue 单文件组件必须显式加"vue" -
format_on_save_excludes的 glob 写法不是 shell 风格，不能写"no/**"，得用"no/**/*"才生效 - 插件自身是否支持该开关：比如
JsPrettier默认不提供保存即格式化，得靠外部监听；而HTML-CSS-JS Prettify在包设置里有独立的Enable Autoformat on Save开关
reindent 为什么缩进全乱了
reindent 不是格式化工具，它只做基础缩进对齐，且高度依赖当前文件状态：
- 右下角必须显示
Spaces: 4（不是Tabs: 4），否则它按 tab_size=2 去换算原始 ，结果只替换成 2 个空格，视觉上就塌了一半 - 文件里混用 和空格时，
reindent会直接拒绝处理（菜单项灰掉），不是 bug，是它的安全策略 -
"detect_indentation": true（默认开启）会让 Sublime 扫描前 200 行，只要发现一个 ，就强制切回 Tab 模式，你设置的"translate_tabs_to_spaces": true全被覆盖——必须在Settings – User里显式设为false，再手动Reload Syntax
CLI 工具路径总配不对
插件不认环境变量，只认你填进配置里的绝对路径，尤其 Windows 下容易栽坑：
-
prettier_cli_path在JsPrettier.sublime-settings中必须写全路径，macOS/Linux 示例："/opt/homebrew/bin/prettier"；Windows 示例："C:\Users\xxx\AppData\Roaming\npm\prettier.cmd"（注意双反斜杠和 .cmd 后缀） - 路径含空格（如
C:Program Files odejsprettier.cmd）会导致调用失败，要么重装 Node 到无空格路径，要么用短路径：C:Progra~1 odejsprettier.cmd -
sublime_black要求"use_stdin": true，否则它读不到当前文件内容，报错error: cannot format stdin
最常被忽略的一点：所有格式化插件都只处理语法合法的内容。JSON 里有单引号、JS 里有尾随逗号、Python 里有未闭合括号——它们不会报错，而是直接跳过。先用终端验证：python -m json.tool yourfile.json 或 black --check yourfile.py，再回头找 Sublime 的问题。
