Sublime Text需装插件并配置CLI路径、语法类型和作用域绑定才能实现Ctrl+Alt+F格式化；常见失败原因包括CLI未加入PATH、配置路径错误、文件类型识别为Plain Text，以及快捷键未按语言作用域区分。
Sublime Text 没有开箱即用的自动格式化功能，所谓“一键排版”必须靠插件调外部工具（如 prettier、black、js-beautify）完成，缺配置、缺 CLI、缺作用域绑定，按快捷键就静默失败。
为什么装了插件还不能 Ctrl+Alt+F 格式化？
常见原因不是插件没装，而是三个环节断了链：
-
prettier或black命令根本不在系统 PATH 里：终端执行prettier --version或black --version报 command not found，就得先npm install -g prettier或pip install black - 插件配置里填的是
prettier，但实际路径是/opt/homebrew/bin/prettier（macOS）或C:\Users\xxx\AppData\Roaming\npm\prettier.cmd（Windows）——必须填绝对路径，且 Windows 要带.cmd - 文件右下角显示的是
Plain Text，不是JavaScript或Python：点一下手动切对语法类型，否则插件压根不响应
怎么给 JS/TS 和 Python 绑不同的快捷键？
不能把所有语言都绑到同一个快捷键上，否则打开 .json 文件却触发 black 会直接报错退出。正确做法是在 Preferences → Key Bindings 用户配置里按作用域写：
[
{
"keys": ["ctrl+alt+f"],
"command": "js_prettier",
"context": [
{ "key": "selector", "operator": "equal", "operand": "source.js, source.ts, source.jsx" }
]
},
{
"keys": ["ctrl+alt+f"],
"command": "black",
"context": [
{ "key": "selector", "operator": "equal", "operand": "source.python" }
]
}
]
注意：source.js 不等于 text.html.basic，HTML 文件要用 html_css_js_prettify 命令，对应 selector 是 text.html.basic。
选中代码块再格式化，为什么有时没反应？
多数插件（如 JsPrettier）默认只处理全文件；想只格式化选区，必须显式启用 selection_only：
- 快捷键配置里加
"args": {"selection_only": true} - 或手动调
Ctrl+Shift+P→ 输入JsPrettier: Format Selection - 但
HTML-CSS-JS Prettify旧版本根本不支持选区，会静默忽略——遇到 Vue 单文件组件或内联模板时，建议关掉自动触发，手动全选再操作
别信“装完就能用”，最常被忽略的三件事
一是改完插件配置（比如 Prettify.sublime-settings）必须重启 Sublime，热重载不生效；二是 reindent 命令只是重缩进，不改引号、括号、换行逻辑，不是真正意义上的格式化；三是控制台报错往往只闪一下，按 Ctrl+` 调出控制台才能看到具体哪一行找不到 prettier_cli_path 或语法不匹配。
