Sublime Text 本身不支持一键自动排版，所有“按一下就整齐”效果均依赖插件调用外部 CLI 工具（如 prettier、black、sqlformat），须同时满足工具已安装、路径配置正确、语法识别准确、快捷键作用域匹配四条件，缺一则静默失败。
Sublime Text 本身不支持一键自动排版，所有“按一下就整齐”的效果都来自插件调用外部 CLI 工具（如 prettier、black、sqlformat），且必须满足工具已安装、路径配置正确、语法识别准确、快捷键作用域匹配四个硬性条件——缺一就会静默失败，连错误提示都没有。
为什么 Ctrl+Alt+L 或 Ctrl+Shift+P → “Format” 没反应？
这不是快捷键没绑好，而是底层调用链断在了某个环节：
- 右下角状态栏显示的是
Plain Text或HTML，但你在编辑.ts文件——插件根本不触发，必须手动点状态栏选成TypeScript -
prettier或black在终端能跑，但在 Sublime 控制台里执行subprocess.run(['prettier', '--version'])报错——说明 Sublime 没读到你的系统$PATH；macOS/Linux 用户需在Preferences → Settings – User中显式加"path": "/opt/homebrew/bin:/usr/local/bin"，Windows 用户要确认C:UsersXXXAppDataRoaming pm已进系统环境变量并重启 Sublime - 快捷键全局绑定，但文件是
.tsx，而配置里只写了["js", "ts"]——得补上"tsx"才触发
JsPrettier 配置 prettier_cli_path 必须写绝对路径
JsPrettier 不会自动查 $PATH，留空或填 "prettier" 就等于没配：
- macOS Apple Silicon：填
"/opt/homebrew/bin/prettier"（不是which prettier输出的软链接路径，得是真实可执行文件） - Windows：必须带
.cmd后缀，例如"C:\Users\xxx\AppData\Roaming\npm\prettier.cmd"；如果 Node 装在C:Program Files odejs，路径含空格会导致调用失败，要么重装到无空格路径，要么用短路径C:Progra~1 odejsprettier.cmd - 改完必须完全退出 Sublime 再重开——插件不热重载配置
sublime_black 和 Pretty JSON 的关键开关
这两个插件看似简单，但默认行为容易踩坑：
-
sublime_black必须设"use_stdin": true，否则无法读取当前文件内容；它不读项目级pyproject.toml，想统一风格得靠全局--line-length参数硬编码进配置 -
Pretty JSON只处理合法 JSON：单引号、尾随逗号、//注释都会让它静默跳过，不报错也不提示；格式化前务必先全选（Ctrl+A）再执行，否则可能只处理光标所在行 - 两者都不支持“保存即格式化”，
format_on_save是 JsPrettier / SQLBeautifier 等插件的专属配置项，别在它们的设置里瞎找
局部格式化比全文件更安全，尤其对混合内容
Vue 单文件组件、带注释的 SQL 片段、含模板字符串的 JS，全选后一键格式化极易出事：
- Vue 文件慎用
HTML-CSS-JS Prettify：它会把<script setup></script>块塞进<style></style>里——不是 bug，是它根本不认识多语言块 - SQLBeautifier 对
/*+ INDEX(...) */这类 hint 支持弱，全选可能破坏执行计划提示 - 正确做法：先手动框选目标代码块（比如只选
<template></template>区域或一段SELECT），再按快捷键；或者用Ctrl+Shift+P输入命令名，明确指定作用范围
最常被忽略的一点：Sublime 启动方式影响环境变量加载。从桌面图标或 Dock 启动时，macOS/Linux 下往往不继承 shell 的 $PATH，导致插件找不到 CLI 工具——这种问题不会报错，只会“点了没反应”，排查时得优先验证 Sublime 控制台里的 import os; os.environ.get('PATH') 是否包含你期望的路径。
