SQL 格式化与团队风格统一：从单行屎山到可读结构

SQL 有几个独特的痛点：

• 关键字密度极高：SELECT/FROM/WHERE/JOIN/GROUP BY/HAVING/ORDER BY/LIMIT 都是关键字，一行写完会把数据列名"夹"成视觉噪音。
• 嵌套层数深：CTE + 子查询能轻松 4-5 层缩进，没有缩进根本看不出 JOIN 在哪一层。
• 方言差异大：MySQL 的 LIMIT 10 OFFSET 5 跟 SQL Server 的 OFFSET 5 ROWS FETCH NEXT 10 ROWS ONLY 长得不一样，格式化器必须方言感知。
• 生产环境常见单行：ORM（如 SQLAlchemy）输出的 SQL 默认是单行；日志工具记录慢查询时也不会保留换行。

格式化把这些噪音变结构，本工具基于 sql-formatter 库支持 11 种方言并保留方言专属语法。

- 关键字大写：SELECT/FROM/WHERE 大写，列名/表名小写。这是 99% 团队的默认风格，AI 与代码 review 工具识别度最高。 - 顶级关键字独占一行：每个 SELECT/FROM/WHERE/JOIN/GROUP BY 单独换行，便于增删块。 - 逗号在前缩进：,column_a 而不是 column_a, ——便于注释掉某行不影响其他行（争议性，本工具默认逗号在后，与多数 ORM 输出一致）。 - JOIN 显式 ON 单独缩进： `` SELECT u.id, u.name FROM users u LEFT JOIN orders o ON o.user_id = u.id WHERE u.status = 1; ``

本工具的「关键字大写」选项默认开启，符合 GoogleSQL Style、SQLAlchemy 默认输出的规范。

不同方言对相同语义有不同写法，格式化器必须理解：

• 字符串拼接：MySQL 用 CONCAT(a, b)、PostgreSQL 用 a || b、SQL Server 用 a + b，格式化时不能误判为加法
• 限制结果数：MySQL LIMIT 10、Oracle ROWNUM <= 10、SQL Server TOP 10、PostgreSQL LIMIT 10 OFFSET 5
• 类型转换：MySQL CAST(x AS UNSIGNED)、PostgreSQL x::int
• 窗口函数：方言对 OVER() 的支持差异，PostgreSQL 最完整
• CTE 语法：标准 SQL 用 WITH x AS (...)，老 Oracle 不支持 CTE 需要改写为子查询

本工具在右上角的方言选择器自动适配解析规则，选错方言可能解析报错或风格异常。

压缩把多行 SQL 折成单行，常见场景：

• 嵌入 JSON 配置（如 Looker 的 LookML、ETL 的 JSON 任务定义），单行更省字段
• 写测试用例：it("should return active users", () => db.query("SELECT * FROM users WHERE status=1"))
• 日志分析：把多行 SQL 折成单行后用 grep 过滤更方便
• 粘贴到聊天工具：单行不会被 IM 自动换行裁剪

但不要为了"看起来短"就压缩生产代码 —— 代码可读性永远比 50 字符的节省重要。

• 预 commit hook：把 sql-formatter 加入 husky pre-commit，强制风格统一
• VS Code 插件：SQL Formatter 或 SQL Database 可一键格式化当前文件
• CI 校验：在 PR check 里跑 sql-formatter --check，发现风格漂移直接 fail
• 对齐 ORM 输出：如果团队主用 Prisma/SQLAlchemy/Knex，把它们生成 SQL 的风格作为格式化基线

本工具不替代 IDE/CI 集成，但作为快速调试入口（粘 SQL → 看清楚结构 → 拷回去）效率最高。