Sublime Text 本身不支持自动排版，所有“自动”效果均依赖插件调用外部 CLI 工具（如 prettier、black），需满足语法识别正确、工具已安装且路径配置准确、扩展名匹配、作用域手动切换等条件，缺一则失效。
Sublime Text 本身不支持整篇文档自动排版，所谓“自动”全是插件调用外部 CLI 工具（如 prettier、black、pretty-json）的结果——没有后台监听、不解析 AST、也不做语义重排，只有手动触发或保存时调用一次命令。
为什么 Ctrl+Alt+L 或 Reindent 没反应
常见断链点不在插件本身，而在底层环境或作用域识别：
- 右下角状态栏显示
Plain Text：插件根本不会响应，必须点击切换为JavaScript、Python、JSON等对应语法 -
reindent命令只对齐缩进，不改括号、引号、空行或运算符换行；它要求文件已正确识别语法 + 全用空格缩进 +"trim_automatic_whitespace": false - 快捷键被其他插件占用（如 Emmet 默认占了
Ctrl+Alt+L），需打开Preferences → Key Bindings查右侧用户配置是否冲突 - 终端能跑
prettier --version，但 Sublime 控制台里subprocess.run(['prettier', '--version'])报错：说明 Sublime 没读到系统$PATH，macOS/Linux 需在Settings – User中显式加"path": "/opt/homebrew/bin:/usr/local/bin"，Windows 要确认C:UsersXXXAppDataRoaming pm在系统环境变量中且 Sublime 已重启
按语言选对插件和命令路径
不同语言不能共用一套配置，插件只是调度器，真正干活的是外部工具：
- JS/TS/JSON：装
JsPrettier，确保npm install -g prettier成功，且插件配置中prettier_cli_path指向绝对路径（Windows 必须带.cmd后缀，如C:\Users\xxx\AppData\Roaming\npm\prettier.cmd） - Python：装
sublime_black，运行pip install black，配置项"use_stdin": true必须开启，否则无法读取当前文件内容 - JSON：装
Pretty JSON，只处理合法 JSON；单引号、尾随逗号、//注释会直接跳过，不报错也不提示 - HTML/CSS/内联 JS：用
HTML-CSS-JS Prettify，但对模板字符串（如`<div>${x}</div>`）易误解析，建议拆离再处理
保存即格式化（format_on_save）为什么静默失败
这个开关极容易配错，且失败时无提示，必须同时满足四条件：
-
"format_on_save": true开启后，"format_on_save_extensions"必须精确匹配扩展名，比如写["js", "ts"]，但文件是.tsx就不会触发 - Vue 单文件组件需额外加
"vue"；Markdown 中的```json代码块不会被格式化，因为作用域是source.embedded.js，不是source.json - 插件配置里
"auto_format_on_save"（JsPrettier）或"format_on_save"（sublime_black）是独立开关，和全局设置不互通，得各自开 - 文件必须已保存（有路径和扩展名），未保存的
untitled标签即使语法设对也不会触发
最常被忽略的其实是「作用域绑定」：哪怕所有工具都装好了，只要右下角没切对语法类型，整个格式化链路就从第一环断掉。别依赖自动识别，手动点一次比查十遍日志更可靠。
