Sublime Text 本身并没有内置的自动排版引擎，所有“保存即整齐”的效果，其实都是靠插件去调用外部命令行工具（比如 prettier、black、gofmt）来实现的。这中间有一个典型的“链条”：工具没装、路径不对、语法识别错误、配置写错——任意一个环节断掉，format_on_sa ve 就会静悄悄地失效，你保存时完全看不出任何变化。
为什么按 Ctrl+Alt+L 没反应？常见断链点
问题往往不是插件没装，而是底层调用卡在了某个环节，下面这几个坑最容易被忽略：
- 环境变量不一致：你在终端里能跑
prettier --version，但 Sublime 的控制台（Ctrl+`）里执行import subprocess; subprocess.run(['prettier', '--version'])却报错——这表示 Sublime 没读到你的$PATH。macOS/Linux 用户需要在 Settings – User 里手动加上"path": "/opt/homebrew/bin:/usr/local/bin"；Windows 用户则要确认C:\Users\XXX\AppData\Roaming\npm已经写进系统环境变量，并且重启 Sublime。 - 语法类型没选对：右下角状态栏显示的是
Plain Text或HTML，而不是Ja vaScript或Python——插件根本不会触发。必须手动点一下，把语法切对才行。 - 快捷键绑错了作用域：比如你把
ctrl+alt+l全局绑定，结果打开.json文件时调用了black，直接报错退出。正确的做法是在 Key Bindings 用户配置里按语言限定：{"keys": ["ctrl+alt+l"], "command": "subl_code_formatter", "context": [{"key": "selector", "operator": "equal", "operand": "source.python"}]}。
Sublime-Code-Formatter 怎么配 Python/JS/TS
这个插件本身不包含格式器，只负责调度。配置时必须显式指定命令和参数，否则它不知道你要用什么工具：
- Python：默认找
autopep8，但如果你装的是black，就得把配置项python_formatter改成black，并且确保black --version能正常执行。推荐命令是["black", "-q", "-"]，同时format_stdin必须设为true，否则插件读不到当前文件内容。 - JS/TS：默认走
prettier，好处是如果项目根目录有.prettierrc，插件会自动加载配置。但团队协作时，如果没在 CI 里加上prettier --check步骤，很容易出现格式化不一致的情况——别跳过这一步。 - Windows 用户特别注意：
prettier.cmd的路径如果包含空格（比如C:\Program Files\nodejs\prettier.cmd），会导致调用失败。要么把 Node 重装到无空格的路径下，要么使用短路径（C:\Progra~1\nodejs\prettier.cmd）。
保存自动格式化（format_on_sa ve）为什么总出问题？
开这个开关之前，必须过三关，少一关就白配：
- 扩展名匹配要精确：
format_on_sa ve_extensions写成["js", "ts"]，但文件是.tsx就不会触发。Vue 单文件组件需要额外加"vue"。 - 排除规则写法不是 shell 风格：
format_on_sa ve_excludes里的 glob 写法，比如"node_modules/**"是错的，得写成"*/node_modules/*"。 - 大文件慎开：生成的
bundle.js如果被误格式化，可能卡住保存流程好几秒。建议设置"format_on_sa ve_timeout_ms": 1000，超时直接跳过。
真正麻烦的地方不在于怎么配，而在于不同项目可能用不同的规则——.prettierrc、pyproject.toml 里的 [tool.black]，光靠编辑器插件没法保证全局一致。正确的做法是，别绕过本地 prettier --check 或 black --check 验证步骤，它们才是最终权威。
