如何格式化 SQL 查询

如何格式化 SQL 查询

赶工写出来的 SQL 像一句没标点的长句:SELECT id,name,SUM(amount) FROM orders o JOIN customers c ON o.cid=c.id WHERE o.status='paid' GROUP BY id,name HAVING SUM(amount)>100 ORDER BY 3 DESC。它能跑,但也确实没法读。

为什么 SQL 格式化重要

  • Bug 藏在长行里——漏掉的 join 条件、本该是 AND 却写成 OR 的逻辑,在一堵文字墙里几乎看不见,在格式化后的代码里一目了然。
  • 审阅者会读它——格式化过的 SQL 有人认真审;没格式化的只会被随手通过。
  • 风格一致——每个查询都按同一版式排列,团队的时间花在逻辑上,而不是解码缩进。

SQL 没有官方风格标准,但事实上的惯例是:每个子句(SELECT、FROM、WHERE)独占一行,select 列表每个字段一行,子查询和 join 统一缩进。

在浏览器里格式化

  1. 把查询粘贴进 SQL 格式化工具。
  2. 工具按标准版式重新缩进:子句分行、字段逐行、子查询嵌套。
  3. 把格式化结果复制回编辑器。

无需上传、无需注册——转换在本地完成。

防止混乱的习惯

  • 边写边格式化:从草稿第一行起就带换行写 SQL,格式化就永远不是任务。
  • 关键字大写:SELECT/FROM/WHERE 大写,表名字段名小写,结构一眼可见。
  • 显式写 join:INNER JOIN ... ON ... 比老式 FROM a, b WHERE a.x = b.x 可读性好,格式化效果也更好。

一遍能读懂的查询,就是一遍能调试的查询。格式化工具两秒钟修复你养成习惯之前写下的一切。