Sublime Text 本身不自动排版,所有“自动排版”均依赖插件调用外部 CLI 工具(如 prettier、black、sqlformat),需同时满足工具已安装、路径正确、语法识别准确、配置无误四条件,缺一则 format_on_save 静默失效。

Sublime Text 本身不自动排版,所谓“自动排版”全是插件调用外部 CLI 工具(如 prettier、black、sqlformat)的结果。只要任一环节断掉——工具没装、路径不对、语法识别错、配置写漏——format_on_save 就静默失效,按快捷键也毫无反应。
为什么 Ctrl+Alt+L / Ctrl+Shift+I 没反应?
这不是快捷键没绑,而是底层调用根本没启动:
- 右下角状态栏显示的是
Plain Text或HTML,但你在编辑.ts文件?插件直接跳过,必须手动点状态栏选成TypeScript -
prettier在终端能跑,但在 Sublime 控制台(Ctrl+`)里执行subprocess.run(['prettier', '--version'])报错?说明 Sublime 没读到你的$PATH;macOS/Linux 用户需在Preferences → Settings – User里显式加"path": "/opt/homebrew/bin:/usr/local/bin";Windows 用户要确认C:\Users\XXX\AppData\Roaming\npm已进系统环境变量,并完全退出重开 Sublime - 快捷键绑在全局,但实际只该用于某语言:比如把
ctrl+alt+l绑给black,结果在.json文件里触发,直接崩溃退出;正确做法是在Key Bindings – User里加context限定:{"key": "selector", "operator": "equal", "operand": "source.python"}
不同语言该用哪个插件和命令?
一个插件通吃所有语言是幻觉,配错轻则无效,重则把类型注解或模板字符串格式化出错:
-
JavaScript/TypeScript/JSON:用
JsPrettier,命令名是js_prettier;它依赖本地prettierCLI,不是 Node.js 自带的,得npm install -g prettier或项目级存在node_modules/.bin/prettier -
Python:用
Sublime-Black或Black插件,命令名是black;别用autopep8,它对f-string、:=海象运算符、Literal类型支持差,容易报invalid syntax -
HTML/CSS/JS 混合文件:用
HTML-CSS-JS Prettify,命令名是html_css_js_prettify;但遇到.vue或.svelte单文件组件会乱缩进,建议关掉format_on_save,只手动选中代码块再执行 -
SQL:用
SQLBeautifier,命令名是sql_beautifier;快捷键默认是两步:Ctrl+K然后Ctrl+F(不是同时按),支持方言切换和关键字大小写控制 -
JSON:用
Pretty JSON,命令名是pretty_json;快捷键是Ctrl+Alt+J,但必须先选中内容或确保整个文件是合法 JSON,否则弹窗提示验证失败
怎么配 format_on_save 才真正生效?
打开这个开关前必须过三关,少一关就白配:
-
format_on_save本身默认是false,得在插件设置里手动设为true(比如JsPrettier的配置项是"auto_format_on_save": true) -
format_on_save_extensions必须精确匹配扩展名:写成["js", "ts"],但文件是.tsx就不会触发;Vue 单文件组件需额外加"vue" - 插件配置里必须指定真实可用的 CLI 路径:比如
JsPrettier需填prettier_cli_path,Windows 上若 Node 装在C:\Program Files\nodejs\prettier.cmd,路径含空格会导致调用失败,要么重装到无空格路径,要么用短路径C:\Progra~1\nodejs\prettier.cmd
快捷键怎么设才不踩坑?
别抄网上的通用 JSON 片段,必须结合上下文和作用域:
- 命令名必须准确:按
Ctrl+Shift+P输入插件关键词(如 “js prettier”),看到的完整命令名才是你要填的,比如js_prettier,不是format_code(原生不存在) - 加
selection_empty限定:比如"selection_empty": true表示“仅当没选中内容时才全文件格式化”,避免误操作把注释块或正则表达式也重排 - 多语言共存时,用
selector显式区分:例如"operand": "source.js, source.ts, text.json",不能写成"operand": "source.js, source.ts, source.json"(JSON 语法是text.json) - 保存后必须完全退出 Sublime 再重开,插件配置不热重载
最常被忽略的一点:所有格式化都依赖文件后缀 + 右下角语法识别双重匹配。哪怕你 prettier 装得再全、路径配得再准,状态栏显示 Plain Text,一切命令都不会触发——这不是 bug,是设计如此。











