首页 工具指南 SQL 该格式化还是压成一行?看这四种场合

SQL 该格式化还是压成一行?看这四种场合

格式化让 SQL 能读,压缩让 SQL 能塞。这篇给出「什么时候排开、什么时候挤一行」的判断标准,以及格式化时最该注意的两件事。

2026 年 10 月 24 日 · 0 次阅读
本文配套工具:SQL 格式化 直接用 →

同一条 SQL,排成多行还是挤成一行,不是审美问题 —— 场合不同,答案就不同。

01该排开的时候

代码评审。 一条两百字符的单行 SQL,评审时没人愿意认真看;排开之后每个 JOIN、每个条件占一行,问题一眼能看出来。

排查慢查询。 执行计划里的问题往往出在某个 JOIN 或某个条件上。排开的 SQL 更容易逐段注释掉、逐个排除。

写复杂查询。 多层子查询、窗口函数、CASE WHEN,挤成一行基本没法维护,改一次错一次。

交接给别人。 半年后的自己也算「别人」。

02该压成一行的时候

写进代码里。 拼接字符串的多行 SQL 会引入一堆换行和缩进空格,日志里看着乱,还容易因为缩进导致语法错。

贴进工单 / 聊天记录 / 邮件。 多行内容经常被自动折行、被 Markdown 吃掉缩进,反而更难读。

作为配置项或命令行参数。 换行会被截断。

做 diff 对比。 两版 SQL 都压成一行再 diff,能直接看出改了哪几个词,不会被格式差异干扰。

03具体格式化的判断标准

工具能自动排版,但「排得对不对」需要人判断。看三点:

  • 每个主要子句另起一行:SELECT / FROM / WHERE / GROUP BY / ORDER BY / HAVING;
  • JOIN 单独一行,ON 条件缩进:这样能看出关联关系和关联键;
  • AND / OR 对齐:尤其是混合了 AND 和 OR 的时候,缩进错了会误读逻辑优先级。

关于 AND 和 OR 混用,有个比排版更重要的提醒:A AND B OR C 的实际含义是 (A AND B) OR C,不是 A AND (B OR C)。排版的缩进一定要跟真实优先级一致,否则读者会被误导。

04格式化时容易碰到的两个问题

字符串里的内容被改动。 有些格式化工具会顺手处理字符串里的空格 —— 但 'hello world'(两个空格)里的空格是数据的一部分,被动过就改变了查询语义。

注释被吃掉或移位。 行注释 -- 后面如果是换行,压缩成一行后注释会把后面的 SQL 全注释掉。压之前先把 -- 注释改成 /* */,或者干脆删掉。

05排版的团队约定

如果一个团队里每个人排得都不一样,diff 会充满纯格式噪音。可以定几条简单约定:

  • 关键字大写(SELECT)还是小写,选一个;
  • 缩进用 2 空格还是 4 空格,选一个;
  • 逗号放行尾还是行首,选一个;
  • 提交前统一跑一次格式化 —— 这条最有用,其它三条都可以商量。

06需要的时候直接用

粘贴 SQL 一键排版,也能反向压成一行;支持复制与分享。

打开SQL 格式化,不用注册,内容不上传。