sublime text 无原生一键格式化功能，需按语言安装对应插件（如jsprettier、black、clang-format）并配置路径，快捷键须按语法作用域绑定，失败时查控制台错误并针对性解决。
Sublime Text 没有原生“一键全文本格式化”功能
Sublime Text 本身不内置代码格式化引擎，所谓“一键格式化”，其实是靠插件调用外部工具（比如 prettier、black、clang-format）完成的。直接按 Ctrl+Shift+P 搜 “Format” 却没反应，大概率是还没装对应语言的格式化插件，或没配好可执行路径。
装什么插件？按语言选，别乱装全局格式化器
不同语言依赖不同格式化工具，强行用一个插件通吃所有文件，容易出错或根本不动。常见组合如下：
-
JsPrettier：适合.js、.jsx、.ts，需本地装prettier（npm install -g prettier） -
SublimeJEDI+autopep8或black：Python 推荐用black，但得确保black命令在系统 PATH 里（macOS/Linux 检查which black，Windows 查where black） -
Clang-Format：C/C++/Obj-C 必备，需单独下载clang-format二进制并配置executable路径 - 别装
CodeFormatter这类老插件——它已多年未更新，对 Python 3.10+ 和现代 JS 语法支持极差
快捷键设置要分语言，不能全绑到 Ctrl+Alt+F
Sublime 默认没有绑定格式化快捷键，手动设时如果统一绑给所有文件类型，会导致打开一个 JSON 文件却调用 black 报错退出。正确做法是按语法作用域绑定：
- 打开
Preferences → Key Bindings - 在用户 keymap 里加条件判断，例如：
[
{
"keys": ["ctrl+alt+f"],
"command": "js_prettier",
"context": [
{ "key": "selector", "operator": "equal", "operand": "source.js, source.jsx, source.ts" }
]
},
{
"keys": ["ctrl+alt+f"],
"command": "black",
"context": [
{ "key": "selector", "operator": "equal", "operand": "source.python" }
]
}
]
注意：context 中的 source.python 是 Sublime 内部语法标识，不是文件扩展名；如果用的是第三方 Python 语法包（如 Python Improved），标识可能变成 source.python.django，得对应调整。
格式化失败？先看控制台里报的哪行错误
按快捷键没反应，或只闪一下就停，打开 Ctrl+` 控制台，常见问题有：
-
File not found: black—— 不是没装black，而是 Sublime 启动时没读取 shell 的 PATH（尤其 macOS GUI 启动时），解决方案：用subl命令从终端启动 Sublime，或在插件设置里硬编码black路径（如/opt/homebrew/bin/black） -
Unexpected token 'export'——prettier版本太低，不支持 ES2022 语法，升级到prettier@3.x - 格式化后缩进变乱 —— 插件和 Sublime 自身的
tab_size/translate_tabs_to_spaces设置冲突，建议插件配置里显式关掉auto_indent，只让格式化工具管缩进
真正麻烦的不是不会配，而是同一项目里混用多种语言（比如 Vue 单文件组件含 <script></script>、<style></style>、<template></template>），此时需要插件支持多段落分别处理——JsPrettier 可以，但默认关着，得在设置里开 "auto_format_on_save": true 并启用 "html_enabled": true。
