SQL 格式化有什么用？查询排查、代码审查和不同方言注意事项

一段压成一行的 SQL 很难读，也很难审查。尤其是有多个 JOIN、子查询、CASE WHEN、GROUP BY 时，格式混乱会直接增加出错概率。

SQL 格式化 / 压缩工具 的价值不只是“美化”，更适合用来排查查询逻辑、做代码审查、整理文档示例。

格式化能暴露结构问题

比如一段 SQL：

select u.id,u.name,count(o.id) from users u left join orders o on o.user_id=u.id where u.status='active' group by u.id,u.name order by count(o.id) desc

格式化后结构更清楚：

SELECT
  u.id,
  u.name,
  COUNT(o.id)
FROM users u
LEFT JOIN orders o ON o.user_id = u.id
WHERE u.status = 'active'
GROUP BY
  u.id,
  u.name
ORDER BY COUNT(o.id) DESC

你可以一眼看到 SELECT、JOIN、WHERE、GROUP BY 是否对应。

审查 SQL 时先看这几处

格式化后建议按顺序检查：

1. SELECT 字段是否只取需要的列。
2. JOIN 条件是否完整，是否漏了关联字段。
3. WHERE 条件是否会误过滤 LEFT JOIN 结果。
4. GROUP BY 是否包含非聚合字段。
5. ORDER BY 是否有索引支持。
6. LIMIT 是否存在，分页是否稳定。

很多慢查询不是语法错，而是逻辑和索引不匹配。

不同数据库方言要选对

PostgreSQL、MySQL、SQLite、BigQuery、SQL Server 的语法有差异。格式化时如果方言选错，某些函数、引号或关键字可能看起来很奇怪。

常见差异：

• PostgreSQL 常用双引号标识符和 ILIKE。
• MySQL 常见反引号和 LIMIT offset, count。
• BigQuery 会有反引号项目路径。
• SQL Server 常见方括号和 TOP。

用 SQL 格式化 / 压缩工具 时，尽量按实际数据库选择方言。

压缩 SQL 什么时候有用

格式化适合阅读，压缩适合复制到配置、低代码平台、日志过滤器或只接受单行 SQL 的地方。

但不建议长期只保存压缩版。团队协作时，格式化版更容易审查和维护。

排查报错的简单流程

如果 SQL 报错，可以这样排：

1. 先格式化。
2. 看括号、引号、逗号是否成对。
3. 把子查询单独拿出来执行。
4. 从 FROM / JOIN 开始逐段加 WHERE。
5. 再加 GROUP BY、HAVING、ORDER BY。
6. 最后看方言是否选错。

这比盯着一整段 SQL 猜错误位置更快。

安全提醒

格式化工具只能帮你看结构，不能证明 SQL 安全。用户输入拼进 SQL 时，仍然要用参数化查询，不要靠转义字符串硬拼。

如果是线上慢查询，格式化后还需要看执行计划、索引和数据量。

总结

SQL 格式化是排查和沟通工具。它能让查询结构变清楚，帮助发现 JOIN、过滤、聚合和排序问题。

需要整理查询时，可以先用 SQL 格式化 / 压缩工具 生成可读版本，再做审查和优化。