Sublime Text 本身不提供自动排版能力，所谓“配置自动排版”本质是装对插件、装好对应 CLI 工具、确保 Sublime 能调通命令；少一个环节，Ctrl+Alt+L 就静默失败，不报错、不提示、也不格式化。
Sublime Text 本身不提供自动排版能力，所谓“配置自动排版”本质是：装对插件 + 装好对应 CLI 工具 + 确保 Sublime 能调通命令。少一个环节，Ctrl+Alt+L 就静默失败，不报错、不提示、也不格式化。
JsPrettier 格式化 JS/TS/JSON 必须过这三关
它不是点开就用的“开关”，而是靠调用本地 prettier 命令实现的管道。常见“没反应”全是卡在某一层：
-
prettier命令必须能在终端执行：prettier --version有输出才算通过；Windows 用户注意路径含空格（如C:\Program Files\nodejs\prettier.cmd）会导致调用失败，要么重装 Node 到无空格路径，要么用短路径（C:\Progra~1\nodejs\prettier.cmd） - Sublime 必须能读到你的
$PATH：macOS/Linux 用户需在Preferences → Settings – User里手动加"path": "/opt/homebrew/bin:/usr/local/bin"；Windows 用户确认C:\Users\XXX\AppData\Roaming\npm已进系统环境变量，并重启 Sublime - 文件语法必须正确识别：右下角状态栏显示的是
Plain Text或HTML？JsPrettier默认不触发。点一下语言名，手动选成JavaScript、TypeScript或JSON
sublime_black 处理 Python 不要碰 AutoPEP8
Python 3.12+ 的 match 语句、带括号的生成器表达式等新语法，AutoPEP8 直接崩溃退出；sublime_black（作者 zabb0t）才是当前最稳的选择。但要注意：
- 必须提前装好
black：pip install black，并确保black --version在终端可运行 - 插件默认找
autopep8，得进Preferences → Package Settings → sublime_black → Settings，把"python_formatter"改成"black" - 关键参数不能漏：
"format_stdin": true（否则读不到当前文件内容），"black_args": ["-q", "-"]（静默模式，避免干扰）
快捷键和保存即格式化的坑在哪
别直接抄网上的 "command": "format_code"——这个命令名根本不存在于原生 Sublime 或主流插件中。可靠做法是：
- 按
Ctrl+Shift+P输入插件功能关键词（如js prettier），看到的完整命令名才是你该填的，比如js_prettier或black - 保存即格式化（
format_on_save）必须配白名单："format_on_save_extensions": ["js", "ts", "json"]；写成["jsx"]却打开.tsx文件？不会触发 - Vue 单文件组件要生效，得额外加
"vue"；且快捷键或保存行为最好加context限定作用域，例如只对source.python生效，避免在 JSON 文件里误调black报错
reindent 不是自动排版，只是缩进对齐
很多人误以为 Ctrl+Shift+P → Reindent Lines 是“一键美化”，但它只做三件事：按当前语法结构对齐缩进层级、不改括号位置、不处理引号/空行/运算符换行。它连基本语法错误都容忍不了：
- 混用
Tab和空格？reindent直接放弃，状态栏提示Mixed indentation detected - 文件语法识别错（比如 .py 文件显示为
Plain Text）？命令灰显，点不动 - 想让它生效，必须先统一缩进：
Convert Indentation to Spaces，再关掉trim_automatic_whitespace（否则格式化后末尾空格被悄悄删掉）
真正容易被忽略的是：所有格式化插件都依赖外部 CLI 工具的可用性，而 Sublime 启动时读取的 PATH 和你终端里的可能完全不同；调试时别只看插件设置，先在 Sublime 控制台（Ctrl+`）里跑 import subprocess; subprocess.run(['prettier', '--version'])，这才是真实调用链。
