如何格式化 SQL 查询：开发者指南
学习如何格式化 SQL 查询以提高可读性和一致性。支持 MySQL、PostgreSQL、SQL Server 等。
为什么要格式化 SQL 查询？
SQL 是关系型数据库的通用语言，但它的格式约定并未标准化。同一个查询既可以写成一行，也可以拆成 30 行用不同缩进——两者执行结果完全相同。格式不会影响数据库的行为——但会极大地影响代码的可读性、可审查性和可维护性。
格式良好的 SQL 查询使用统一的大小写、清晰的换行和缩进的子句。这让发现 bug、新人上手、在长查询中定位字段都更容易。SQL 格式化工具能在几秒内把这些工作自动完成，省去手工劳动。
常见使用场景
- 代码审查：让审查者读得清楚
- 调试：在又长又复杂的 JOIN 中发现逻辑错误
- 文档：在教程、运维手册和 wiki 中分享查询
- 风格统一：在整个代码库中强制执行团队风格
- 迁移：在到达生产环境前审查 schema 变更
方法 1：使用 UtilBoxx 免费 SQL 格式化器（推荐）
我们的 SQL 格式化器 支持多种方言（MySQL、PostgreSQL、SQL Server、Oracle、SQLite），并允许你调整缩进、关键字大小写和换行。步骤如下：
- 访问 utilboxx.com/zh/tools/dev/sql
- 把 SQL 粘贴到输入面板
- 选择方言和格式风格
- 立即看到格式化结果
- 一键复制
这个方法的优势：
- 支持 MySQL、PostgreSQL、SQL Server、Oracle、SQLite
- 可配置缩进和关键字大小写
- 保留注释和字符串字面量
- 移动端友好，输入面板大
- 完全在浏览器中运行，查询不上传
方法 2：使用命令行工具
自动化方面，流行的 `sqlfluff` 和 `pgFormatter` 工具可在命令行使用：
```bash # 安装 sqlfluff pip install sqlfluff
# 格式化 SQL 文件 sqlfluff format --dialect postgres query.sql ```
`sqlfluff` 同时支持 lint 和风格规则强制执行，非常适合 CI 流水线和 pre-commit 钩子。
方法 3：使用编辑器扩展
大多数 SQL 客户端和编辑器内置或通过扩展支持格式化：
- VS Code：配合 SQLTools 扩展使用"格式化文档"命令
- DataGrip：内置格式化器，每种方言都有专门设置
- DBeaver：按 Ctrl+Shift+F 格式化当前 SQL 编辑器
- pgAdmin：内置 PostgreSQL 查询格式化器
如果已经在编辑器中，这是最快的方式。
常见问题
格式化会改变查询行为吗？
不会。SQL 对空白不敏感（字符串字面量内除外）。同一个查询无论是一行还是五十行，结果都一样。格式化纯粹为了可读性。
应该选哪种 SQL 方言？
选与你的数据库引擎匹配的方言。PostgreSQL 和 MySQL 在某些语法细节上不同（如反引号 vs 双引号标识符），所以选对方言能确保格式化器使用正确的约定。
应该在生产代码中格式化查询吗？
应该。在 pre-commit 钩子或 CI 流水线中使用自动格式化器，能保证代码库中所有查询都遵循团队风格。这能消除关于格式的争论，让审查聚焦在内容上。
格式化器会破坏有效查询吗？
好的格式化器不应该改变语义，但确实偶尔会出错——特别是复杂的 CTE、过程式 SQL 或方言特有功能。自动格式化后始终要检查 diff，特别是存储过程。
结论
格式化你的 SQL——未来的你和队友都会感谢你。想要一个浏览器内、快速的格式化器，把 UtilBoxx SQL 格式化器 一直开着是最简单的方式。