Sublime Text 本身不支持自动格式化，必须依赖插件+外部CLI工具+正确路径配置三者联动；90%失效源于PATH不一致，需用终端启动（macOS/Linux运行subl，Windows运行subl.exe）并手动填绝对路径。
Sublime Text 本身不支持“自动清理格式化”——它没有内置的保存即格式化、语法感知重排、空格/空行/引号统一等能力。所谓“自动”，必须靠插件 + 外部 CLI 工具 + 正确路径配置三者联动，缺一不可。
为什么 Ctrl+S 后代码没变？PATH 和启动方式是最大拦路虎
90% 的“自动格式化不触发”问题，不是插件没装，而是 Sublime 启动时根本找不到 prettier、black 或 php-cs-fixer：
- macOS/Linux：从 Dock 或桌面图标启动 Sublime，它不继承 shell 的
PATH，which prettier在终端能查到，但在 Sublime 里就是command not found - Windows：
npm install -g prettier安装的是prettier.cmd，插件配置里写成prettier就会静默失败 - 解决办法只有一条：用终端启动——macOS/Linux 运行
subl，Windows 运行subl.exe（确保该命令在当前 shell 可用）
不同语言必须配不同的插件和 CLI，混用必出错
一个插件打天下？不存在。每种语言的格式化逻辑、依赖工具、配置粒度都不同：
- JS/TS/HTML/CSS：用
JsPrettier插件，依赖全局prettierCLI；项目级配置靠.prettierrc，但插件默认读不到，得在用户设置里加"prettier_options": { "config": ".prettierrc" } - Python：选
Black Formatter（激进重写）或AutoPEP8（保守修复），二者不能共存；若用pyproject.toml配black，插件里必须显式传参："black_args": ["--config", "pyproject.toml"] - PHP：用
phpfmt，它默认调内部 formatter，要 PSR-12 就得配php_bin指向php-cs-fixer，路径必须是绝对路径，且php-cs-fixer要有可执行权限 - SQL：用
SQLBeautifier，快捷键是两步：Ctrl+K然后Ctrl+F，不能绑定成单快捷键；它的配置项如indent_size必须写在sqlbeautify_options对象里，平级写无效
reindent 不是自动格式化，别拿它凑数
reindent 命令常被误当作“轻量自动格式化”，但它只干一件事：按当前语法识别结果，重新计算缩进层级。它不碰换行、不修空格、不校验括号、不处理字符串内嵌逻辑：
- 右下角显示
Plain Text→ 直接失效 - 选区跨
{或[层级（比如只选了 if 块里一半）→ 静默跳过 - HTML 文件里混了
onchange="return a&&b?"这种 JS 字符串 → 缩进可能全乱 - Python 中用了 f-string 或类型注解 → 它不理解，缩进可能错位
自动格式化的最后一道防线：检查控制台报错
Sublime 底部状态栏一闪而过没反应？打开 Ctrl+` 调出控制台，看有没有类似这些输出：
-
Unable to find 'prettier' in PATH→ CLI 工具路径不对或没安装 -
command 'phpfmt_format' not found→ 插件没加载成功，重启 Sublime 并确认 Package Control 已就绪 -
Invalid syntax in file.py→black或autopep8解析失败，先手动修语法错误再试 -
jsprettier: error: unknown option '--config'→ prettier CLI 版本太老，升级到 v3+ 再试
真正可靠的自动格式化，从来不是“装完插件就完事”，而是每次换机器、换 Node/Python 版本、甚至换 shell 配置，都得重新验证 CLI 是否可达、插件是否注册、快捷键 context 是否匹配——这些细节不盯住，再多的配置都是摆设。
