sublime text 本身不自动排版，所有“保存即整齐”效果均依赖插件调用外部 cli 工具（如 prettier、black），需同时满足工具已安装、路径正确、语法识别准确、配置无误四条件，缺一则 format_on_save 静默失效。
Sublime Text 本身不自动排版，所有“保存即整齐”效果都来自插件调用外部 CLI 工具（如 prettier、black、gofmt），缺一不可：工具没装、路径不对、语法识别错、配置写错，任意一个环节断掉，format_on_save 就静默失效。
为什么按 Ctrl+Alt+L 没反应？常见断链点
不是插件没装，而是底层调用卡在某个环节：
-
prettier或black命令在终端能跑，但在 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，不是JavaScript或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，插件会自动加载；没配的话，团队协作容易格式不一致 —— 别跳过prettier --check这类 CI 步骤 - Windows 用户注意：
prettier.cmd路径含空格（如C:\Program Files\nodejs\prettier.cmd）会导致调用失败，要么重装 Node 到无空格路径，要么用短路径（C:\Progra~1\nodejs\prettier.cmd）
保存自动格式化（format_on_save）为什么总出问题？
开这个开关前必须过三关，少一关就白配：
-
format_on_save_extensions必须精确匹配扩展名，比如写成["js", "ts"]，但文件是.tsx就不会触发；Vue 单文件组件需额外加"vue" -
format_on_save_excludes的 glob 写法不是 shell 风格："node_modules/**"是错的，得写成"*/node_modules/*" - 大文件慎开：比如生成的
bundle.js被误格式化，可能卡住保存流程几秒；建议设"format_on_save_timeout_ms": 1000，超时直接跳过
真正麻烦的不是怎么配，而是不同项目用不同规则（.prettierrc、pyproject.toml 里的 [tool.black]），光靠编辑器插件没法保证一致。别绕过本地 prettier --check 或 black --check 验证步骤 —— 它们才是最终权威。
