SQL美化格式化

格式化会改什么，不会改什么

一条挤在单行里的查询，可以被拆成SELECT、FROM、JOIN、WHERE、ORDER BY、LIMIT等更易阅读的层次。页面主要调整空白、缩进、换行和SQL关键字大小写，并给输入、输出分别统计字符数与行数。它不会连接数据库、执行语句、读取表结构，也不会根据业务目标改写JOIN条件或WHERE逻辑。

输出仍是文本SQL，可复制，也可下载为formatted.sql。输入或选项改变后，右侧会重新生成结果；空输入不会产生输出。若解析失败，输出区会显示错误，原始输入仍留在左侧供修改。

五种方言与三类排版参数

“关键字大小写”针对被识别为SQL关键字的词，不等于把整段文本统一改成大写或小写。字符串字面量、带引号标识符和普通标识符有各自的数据库规则。

为什么先选方言再看结果

不同数据库对引用符和扩展语法的解释并不完全一致。例如MySQL通常用反引号引用标识符，而PostgreSQL用双引号创建带界限的标识符；PostgreSQL未加引号的名称会折叠为小写，SQL标准口径则不同。包含反引号、双冒号类型转换、美元引号、特定函数或过程语法时，错误方言可能造成不理想的断行，甚至无法解析。

从粘贴到导出的操作顺序

1. 选择数据库口径

   先从“语言/方言”选择SQL实际运行的数据库。若语句只使用通用SELECT、JOIN、WHERE等结构，可先选Standard SQL。

2. 粘贴原始SQL

   把语句放入左侧输入区；也可载入页面示例观察排版。结果会在右侧生成，不需要单独提交。

3. 统一团队风格

   按代码规范选择2、4或8格缩进，决定使用空格还是Tab，并将关键字设为Upper、Lower或Preserve。

4. 检查高风险片段

   重点核对字符串、注释、带引号表名/列名、参数占位符、存储过程和数据库专属语法。格式美观不代表语法或业务逻辑已通过验证。

5. 复制或下载

   确认结果后复制文本，或下载formatted.sql。正式执行前仍应在目标数据库的测试环境完成语法检查。

可复现的格式化示例

默认选Standard SQL、2个空格、空格缩进、关键字大写，输入：

SELECT users.id,users.name,orders.total FROM users INNER JOIN orders ON users.id=orders.user_id WHERE orders.status="completed" ORDER BY orders.created_at DESC LIMIT 10;

右侧会把字段列表和主要子句分行，并在INNER JOIN、WHERE、ORDER BY与LIMIT处形成层次。把缩进改为4只改变层级宽度；把关键字改为Lower会输出select、from等小写关键字，不应改变字段名和字符串内容。这个例子适合核对排版选项，但其中双引号字符串是否适用于目标数据库仍取决于方言与数据库模式。

格式异常与兼容性问题

执行前必须保留的校验

格式化结果不能替代数据库解析、执行计划检查、事务审查或代码评审。尤其是UPDATE、DELETE、DROP、ALTER等语句，不应因排版成功就直接在生产库运行。

• 关键字大小写转换与标识符大小写是两件事；带引号名称可能区分大小写，错误方言可能造成误读。
• 动态SQL、模板占位符、厂商扩展、嵌套注释和过程语言可能超出通用格式化范围。
• 页面不读取数据库结构，因此无法发现不存在的表/列、类型不匹配、权限不足或缺失索引。
• 含账号、令牌、个人信息或业务机密的SQL应先脱敏，再复制到任何网页环境。