Sublime怎么实现自动排版？不同语言代码格式化

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 验证步骤，它们才是最终权威。