SQL 格式化

转换器

基于正则的 SQL 格式化器,自动缩进并把关键字大写,按子句换行,适合整理慢查询日志、审阅 ORM 输出与统一团队 Code Review 风格。格式化时原样保留字符串与注释;只调整版式,不改动语义,结果可直接复制回编辑器。

输入 → 输出
12 行 · 221 字符
SQL输入
SQL输出

关于 SQL 格式化

SQL 格式化工具按照关键字、缩进与换行规则把杂乱的 SQL 语句美化为易读结构,并高亮 SELECT、JOIN、WHERE 等关键字,清晰展示子查询与多表关联的层级关系。它适合在代码评审、日志排查与接口调试中快速读懂长 SQL,也提供压缩模式便于嵌入代码或配置。例如把 SELECT id,name FROM users WHERE age>18 重排为多行缩进结构,并高亮 SELECT、FROM、WHERE 关键字,一眼看清查询层级。格式化后再对照执行计划检查关联顺序与过滤条件,往往能发现被缩进掩盖的逻辑问题。压缩模式便于把长语句塞进配置或日志,排查线上慢查询时先格式化再阅读,比直接看一行挤在一起的语句省时得多,也更利于团队内部沟通。

格式化语句时最需要保护的是字符串与注释,因为其中的内容不遵循语法规则。字符串里可能出现与关键字或运算符相同的片段,若被纳入排版逻辑就会产生错误结果;注释内容同理,被移动或合并可能改变其含义。因此实现应当先识别这些区域并原样保留,只在其外部做缩进与换行调整。

关键字的大小写与函数名的大小写在实际执行中通常不敏感,但在阅读与检索时意义不同。统一大写关键字、保留标识符原样,是常见约定,便于一眼区分语法元素与自定义名称;而函数名若被强制大写,可能与某些数据库的约定冲突。因此在格式化前应当确认目标数据库的惯例,而不是套用通用规则。

方言差异决定了格式化不能只按一种语法处理。不同数据库在标识符引用符号、字符串拼接、分页写法与自增列定义上各不相同,而格式化工具若不识别方言,可能把合法的写法当作错误结构处理,或对某些特有语法束手无策。因此面对特定数据库的语句,应当选用支持该方言的实现。

子查询与联结的结构最能体现格式化的价值,也最容易做得难以阅读。把子查询缩进到独立层级、让每个联结条件各占一行、并把选择列逐行列出,能让逻辑层次一目了然;反之,全部堆在一行会让人无法看清条件之间的关系。因此格式化的目标是「显出结构」,而不是把行数压到最少。

长列表需要特殊处理,否则会成为可读性的重灾区。当条件里包含大量取值时,逐行展开会占满屏幕,压成一行又完全无法核对;此时按固定个数分行(例如每行若干项)能在可读与紧凑之间取得平衡。此外对这类长列表,格式化不应重排其中元素的顺序,因为顺序有时具有业务含义。

最后,格式化只改变外观,不影响执行结果,但这并不意味着可以随意重排。语句的语义由结构与条件决定,而某些数据库依赖提示注释或语句顺序来影响执行计划;若格式化挪动了这类注释的位置,性能可能发生明显变化。因此在格式化后应当核对关键注释仍在原位,并在重要语句上做一次执行计划的比对。

实现原理

格式化把语句按语法结构重新排版:关键字大写、子句各占一行、缩进体现嵌套层级。它只改版式不改语义,因此不能代替对执行计划的判断——同样的语句换个缩进性能完全一致。它的价值在于让「这条语句到底查了哪张表、条件是什么」在评审时一眼可见,尤其是多层嵌套子查询。

同一语句的两种排布
输入select a,b from t where id=1
输出SELECT a, b FROM t WHERE id = 1

本页实测数据

修复:字面量被压平旧实现先对全文做 \s+ → ' ',字符串里的连续空格与换行被压成一个空格:'a b' 变 'a b'、'multi\nline' 拼成一行——查询语义直接变了。现在先把字面量抽成占位符再压平
修复:字面量被关键字污染WHERE name = 'from the start' 里的 from 会被关键字大写规则改成 FROM,字符串内容被改写。占位符方案后字面量原样保留
修复:注释被拆开-- keep it 这样的注释会被压平、其中的关键字被大写、还会被 AND/OR 规则断行。现在注释与块注释一并保护
正常格式化不变关键字大写、FROM/WHERE/ORDER BY 前断行、SELECT 多列各占一行——这些行为对 SQL 骨架部分保持不变

格式化器的第一原则是不改语义,SQL 里最容易破这条的就是字符串字面量与注释(本页 2 处缺陷都源于此):它们内部可以有任意空白、任意关键字单词,而压平全文 + 全文替换关键字的实现会同时踩两个坑。本页原先 \s+ → ' ' 会把 'a b' 变成 'a b'(两个空格变一个),把 'from the start' 里的 from 大写成 FROM——这类改动肉眼难察,但执行结果可能不同。修法是把字面量与注释先抽成占位符,只格式化 SQL 骨架,最后原样还原。仍属简化实现:不做方言特性(如 $$ 美元引号、[] 标识符)、不重排 JOIN 顺序。

测量方式: 输入 4 条 SQL(含双空格字符串、含关键字单词的字符串、行注释、多行字符串),核对格式化输出里字面量与注释是否逐字符保持。修复前后各量一次。 · 实测于 2026-10-31

使用方法

  1. 打开「SQL 格式化」
  2. 粘贴要整理的 SQL 语句
  3. 关键字自动大写并按子句断行
  4. 核对字符串与注释未被改动
  5. 点击「复制」取用排版结果

使用场景

  • 美化日志 SQL — 把日志里挤成一行的慢查询格式化,看清 JOIN 和子查询结构。
  • 审阅 ORM 输出 — 格式化 ORM 生成的 SQL,确认它是否产生了预期的查询。
  • 优化前梳理 — 把复杂查询排版清晰,定位多余的子查询或缺失的索引条件。
  • 统一团队风格 — 把同事写法各异的 SQL 统一缩进风格,方便 code review。
  • 教学讲解 — 把嵌套查询分层展开,向新人讲解执行逻辑与条件关系。

常见问题

会改变 SQL 的执行结果吗?

不会。格式化只调整空白、换行和缩进,不改动关键字、字段和逻辑,语义与执行结果完全一致。

支持哪些数据库方言?

对标准 SQL 以及 MySQL、PostgreSQL 等常见方言的语法都能良好排版。少数厂商特有语法可能不被完全识别,但通常不影响整体格式化。

关键字会被改成大写吗?

工具通常会把关键字统一为大写以提升可读性,字段名和值的大小写保持不变。

能压缩成一行吗?

本工具侧重美化排版。若需要把多行 SQL 压成单行用于嵌入代码,可手动去除换行,或在支持压缩的模式下处理。

注释会被保留吗?

常见的单行(--)和多行(/* */)注释一般会被保留并合理放置,但极个别位置的注释可能被重新换行,建议格式化后快速核对。

很长的 SQL 会卡吗?

本工具在浏览器本地处理,只做词法层面的空白与缩进重排,不执行查询也不解析数据,所以一般几千行、上万行的 SQL 都能顺畅格式化。极少数带大量深层嵌套子查询的超长语句,首次高亮排版时可能出现短暂卡顿,通常等一次渲染即可;若持续卡顿,可把语句拆成多段分开处理,或先剔除日志行里夹带的非 SQL 噪音文本再放回来,而不是依赖一次格式化整段巨型语句。

把生产环境的 SQL 粘进来,会被上传吗?

不会。整个格式化与高亮过程都发生在你的浏览器本地,SQL 文本不会发送到任何服务器,也不会被记录或用于训练,因此可以放心粘贴生产库的慢查询日志或含敏感列的语句。对于内网或高合规环境,仍建议按公司规范对库名、表名适当脱敏后再粘贴;本地处理只解决数据不出浏览器的问题,并不能替你规避其它网络层面的风险。

格式化后 SQL 关键字没变大写?

缩进与换行是格式化的一部分,关键字大写是风格选项,默认不改写大小写(改写会影响字符串里的字面量与别名)。需要统一大写时在选项里开启关键字大写,并检查字符串常量没有被误改。