你需要看懂的那条查询，往往不是你写的。它来自一份日志、一个 ORM、同事发来的一条消息：一整行，四个 join，还有一个找不到尽头的 where。这个页面把它拆到各行，让结构显出来；等到别的东西要读它时，再收回一行。

使用方法

1. 1 粘贴查询——一条语句或者整个脚本都行。
2. 2 选好缩进，然后点格式化或压缩。
3. 3 文字会在同一个框里变化——复制它，或者点撤销。

单行注释，在没有行的地方就是隐患

「--」注释一直管到行尾。压缩会去掉换行，所以留在原地的注释会把后面的一切都吞掉：查询照样能跑，只是悄悄地跑到一半就停了。所以这里的压缩会把行注释整个删掉——也所以字符串里的「--」原封不动，因为在那里它是数据，不是注释。

引号，以及成双的引号

在 SQL 里，字符串内部的引号靠写两遍来转义：'O''Brien'。在第二个引号处就把字符串关掉的工具，会把名字的后半截当成代码读，从那以后它找到的每个关键字都是幻觉。带引号的标识符同理——`order`、"group"、[limit] 都是名字，名字里的关键字不是关键字。

它绝不改写你的查询

关键字不会被改成大写，括号不会被简化，别名不会被改名。动的只有空白。这一点很要紧，因为格式化后的查询通常要回到一个团队会评审的文件里：满屏大小写变更的 diff，会把真正改动的那一行藏起来；而小写关键字是团队风格，不是错误。

格式化不等于检查

这个页面从不连接数据库，所以它不知道某张表存不存在、你的 join 对不对、这条查询会不会慢。它读的是文本，动的是空白。它真正给你的是形状——而一条你能看清形状的查询，才是你能推敲的查询。