SQL 格式化完全指南：美化、压缩与调试技巧

为什么需要格式化 SQL？

-- ❌ 压缩为一行，难以阅读
SELECT u.id,u.name,o.total FROM users u JOIN orders o ON u.id=o.user_id WHERE o.status='paid' AND o.created_at>'2024-01-01' ORDER BY o.total DESC LIMIT 10;

-- ✅ 格式化后，结构清晰
SELECT
  u.id,
  u.name,
  o.total
FROM users u
JOIN orders o ON u.id = o.user_id
WHERE o.status = 'paid'
  AND o.created_at > '2024-01-01'
ORDER BY o.total DESC
LIMIT 10;

格式化让 SQL 的 SELECT → FROM → JOIN → WHERE → ORDER BY 结构一目了然。

---

使用工具库 SQL 格式化

操作步骤

1. 打开 SQL 格式化工具
2. 粘贴 SQL 语句
3. 自动美化（关键字大写、缩进对齐）
4. 也可切换为压缩模式（去除空白）

支持的 SQL 方言

方言	说明
SQL	标准 SQL
MySQL	MySQL 特有语法
PostgreSQL	PG 特有语法
SQLite	轻量数据库
T-SQL	SQL Server
PL/SQL	Oracle

---

格式化规范

关键字大写

SELECT, FROM, WHERE, JOIN, ON, AND, OR, ORDER BY, GROUP BY, HAVING, LIMIT

缩进规则

SELECT
  column1,
  column2,
  CASE
    WHEN condition1 THEN result1
    WHEN condition2 THEN result2
    ELSE default_result
  END AS calculated
FROM table1
  JOIN table2 ON table1.id = table2.ref_id
WHERE status = 'active'
  AND created_at >= '2024-01-01'
GROUP BY column1, column2
HAVING COUNT(*) > 5
ORDER BY column1 DESC;

子查询缩进

SELECT *
FROM (
  SELECT
    user_id,
    SUM(amount) AS total
  FROM orders
  WHERE status = 'paid'
  GROUP BY user_id
) AS user_totals
WHERE total > 1000;

---

实战场景

1. 日志中的 SQL 调试

生产环境日志常输出压缩 SQL：

[2024-06-01 10:00:00] QUERY: SELECT * FROM users WHERE email='test@example.com' AND deleted_at IS NULL

复制到 SQL 格式化工具 美化后分析。

2. ORM 生成的 SQL

// Sequelize / TypeORM 生成的 SQL 通常没有格式
console.log(query.getSql());
// → SELECT `User`.`id`, `User`.`name` FROM `users` AS `User` WHERE ...

格式化后理解 ORM 实际执行的查询。

3. JSON 数据转 SQL

API 返回 JSON 数组，需要生成 INSERT 语句：

[
  {"name": "Alice", "age": 30},
  {"name": "Bob", "age": 25}
]

使用 JSON 转 SQL 工具 自动生成：

INSERT INTO users (name, age) VALUES ('Alice', 30);
INSERT INTO users (name, age) VALUES ('Bob', 25);

4. 压缩 SQL（节省传输）

格式化后的 SQL 用于阅读，压缩后的 SQL 用于传输：

-- 格式化: 15 行, 380 字符
-- 压缩: 1 行, 195 字符 (减少 49%)

---

常见 SQL 格式化问题

字符串中的关键字不会被大写

-- ✅ 正确：'select' 在字符串中保持不变
SELECT * FROM logs WHERE message LIKE '%select%'

注释保留

SELECT id, name  -- 用户名
FROM users       /* 活跃用户数 */
WHERE status = 1

格式化工具会保留单行 -- 和块 /* */ 注释。

---

总结

SQL 格式化是数据库开发者的高效习惯。工具库 SQL 格式化工具 支持多种 SQL 方言，浏览器本地处理，配合 JSON 转 SQL 工具可以完成从数据到 SQL 的完整工作流。