Sublime Text 本身不支持真正意义上的“自动排版”,所有规范排版均依赖插件调用外部 CLI 工具(如 prettier、black),缺工具、路径、语法识别或配置任一环节即静默失败。

Sublime Text 本身不支持真正意义上的“自动排版”,所谓规范排版,本质是靠插件调用外部 CLI 工具(如 prettier、black、phpfmt)完成的——没装工具、路径不对、语法识别错、配置漏项,任意一个环节断掉,格式化就静默失败。
为什么 reindent 不是自动排版
reindent 是 Sublime 内置命令,只做缩进对齐,不改结构、不调括号、不统一引号、不处理空行。它生效有硬性前提:
- 右下角状态栏必须显示正确语法(如
JavaScript,不是Plain Text) - 文件缩进必须统一(全空格或全 Tab;混用时
reindent直接跳过) - 设置里
trim_automatic_whitespace得设为false,否则末尾空格会被悄悄删掉,干扰后续格式化
JsPrettier 格式化 JS/TS/JSON 的三个死线
装了插件 ≠ 能用。它本质是调本地 prettier CLI,必须同时满足:
-
node -v和prettier --version在终端能正常返回 —— 检查 Node.js 是否在PATH中 -
prettier命令在 Sublime 控制台(Ctrl+`)里也能执行:import subprocess; subprocess.run(["prettier", "--version"]) - 插件配置中
auto_format_on_save默认是false;如需保存即格式化,得手动打开,但更推荐保持关闭,避免误触污染团队风格
快捷键绑定必须按语言限定作用域
全局绑定 ctrl+alt+l 到 js_prettier,在 .py 文件里按下去会直接报错退出。正确做法是加 context 限定:
[
{
"keys": ["ctrl+alt+l"],
"command": "js_prettier",
"context": [
{ "key": "selector", "operator": "equal", "operand": "source.js" }
]
},
{
"keys": ["ctrl+alt+l"],
"command": "black",
"context": [
{ "key": "selector", "operator": "equal", "operand": "source.python" }
]
}
]
注意:source.js 对应 JS 文件,source.python 对应 Python;写成 text.html 或 embedding.python(如 .vue 里的 script 块)可能不触发。
format_on_save 总失效?检查这四点
这个开关看着简单,实际是四层过滤器,缺一不可:
-
format_on_save本身设为true -
format_on_save_extensions必须精确匹配扩展名:写["js"],.jsx就不触发;Vue 单文件组件要加"vue" - 当前文件语法类型必须被插件支持(比如
sublime_black不处理source.ts) - Windows 用户注意:
prettier.cmd路径含空格(如C:\Program Files\nodejs\prettier.cmd)会导致调用失败,要么重装 Node 到无空格路径,要么用短路径C:\Progra~1\nodejs\prettier.cmd
最常被忽略的是:插件根本没读到你的系统 PATH,尤其 macOS/Linux 用户得在 Settings – User 里显式加 "path": "/opt/homebrew/bin:/usr/local/bin",否则 which prettier 在终端能查到,Sublime 里照样找不到。











