Sublime Text 本身不支持自动排版 SQL,需手动触发 SQLBeautify 插件格式化;推荐配置 keyword_case 为 "upper"、comma_style 为 "after"、indent_after_each_comma 为 true,并手动选中纯 SQL 块操作,复杂查询仍需人工微调。

Sublime Text 本身不支持自动排版 SQL,所谓“自动”其实是手动触发插件格式化命令——没有保存即格式化、没有后台监听、也没有语法树级重排,只有选中代码后一键调用美化工具。
SQLBeautify 是目前最稳的格式化选择
它专为 SQL 设计,轻量、无数据库连接依赖、纯本地处理,且配置项直击常见需求。其他插件如 SQLTools 或 SublimeAStyleFormatter 要么功能冗余(带连接功能),要么需额外安装外部二进制(如 astyle),容易卡在路径或权限上。
- 安装前确认已装
Package Control:按Ctrl+`粘贴官方安装脚本,重启后再操作 - 安装时搜索
SQLBeautify(注意拼写,不是 SQLBeautifier 或 SQLPrettyPrinter) - 默认快捷键是
Ctrl+Alt+B(Windows/Linux)或Cmd+Alt+B(macOS),但首次使用前建议先选中一段 SQL 再触发,避免作用于整个文件中的非 SQL 内容 - 若快捷键无效,按
Ctrl+Shift+P输入Beautify SQL手动调用,确认命令存在且插件已加载
关键字大小写和逗号位置必须手动配
默认设置下,SELECT 可能被转成小写,字段列表里的逗号也可能跑到行尾而非行首,导致可读性反而下降。这些不是 bug,而是插件默认风格,必须改配置。
- 进入
Preferences → Package Settings → SQLBeautify → Settings - 填入关键项(JSON 格式):
{ "keyword_case": "upper", "comma_style": "after", "indent_after_each_comma": true, "indent_size": 2 } -
"comma_style": "after"表示逗号放在当前字段末尾;若要逗号前置(如每行开头一个逗号),得设为"before"并配合"indent_with_tabs": false避免缩进错乱 - 改完设置不生效?检查是否误改了
Settings – Default——必须只改Settings – User
别指望 reindent 或 Toggle Word Wrap 替代格式化
reindent 是 Sublime 内置命令,只对齐缩进层级,不会拆分 SELECT a, b, c FROM t WHERE x=1 AND y=2 这种长行;Toggle Word Wrap(即 "word_wrap": true)只是软换行显示,复制出来仍是单行,对协作或 Git diff 完全没用。
- 开启软换行路径:
View → Word Wrap,或用户设置里加"word_wrap": true - 它不影响实际换行符,也不改变 SQL 语义,仅用于阅读宽字段列表时避免横向滚动
- 想让字段竖排对齐(如每个字段独占一行、
AS对齐),得用AlignTab插件,但那是结构对齐,不是语法格式化,二者目的不同,别混用
真正麻烦的是嵌套子查询或 CTE(WITH 块)——SQLBeautify 对多层括号缩进的支持有限,有时会把 FROM (SELECT ...) 里的内容压成一行。这种场景下,格式化后仍需人工微调缩进或换行位置,不能完全交出去。


















