🗃 SQL 格式化工具
美化SQL语句、关键词大写、语法高亮，支持多种SQL方言
什么是 SQL 格式化工具？
SQL 格式化工具是一款将混乱的 SQL 语句自动美化为规范格式的在线工具。在实际开发中，SQL 查询可能来自代码生成器、日志文件、数据库管理工具或同事的代码，格式往往混乱不堪——没有缩进、关键字全部小写、子查询嵌套难以辨认。混乱的 SQL 不仅难以阅读和维护，还可能在团队协作中引发理解错误。本工具基于标准 SQL 格式化规则，自动对关键字进行大写规范化、添加合理缩进和换行、对齐子句结构，支持 SELECT、INSERT、UPDATE、DELETE、CREATE、ALTER 等所有 SQL 语句类型，同时兼容 MySQL、PostgreSQL、SQL Server、Oracle、SQLite 等主流方言。
如何使用 SQL 格式化工具
- 步骤一：粘贴 SQL 语句 — 将格式混乱的 SQL 粘贴到输入框中。工具支持单条语句和多条语句的批量格式化。
- 步骤二：选择格式化选项 — 设置缩进方式（空格数或 Tab）、关键字大小写（大写/小写）、逗号位置（行首/行尾）、最大行宽等参数。
- 步骤三：获取格式化结果 — 格式化后的 SQL 以语法高亮方式显示在输出区。一键复制格式化后的 SQL 代码，粘贴到你的 IDE 或数据库管理工具中。
常见使用场景
场景一：审查和优化慢查询
从慢查询日志中提取的 SQL 通常是一整行。格式化后可以清晰地看到查询结构：哪些表参与了 JOIN、WHERE 条件如何组合、子查询在哪里嵌套，帮助快速定位性能瓶颈。
场景二：代码审查中的 SQL 规范化
团队协作时，统一的 SQL 格式规范提高代码可读性。在 PR 中使用格式化工具统一 SQL 风格，减少因格式问题导致的无意义 code review 讨论。
场景三：SQL 教学和学习
格式化后的 SQL 结构清晰，适合教学场景。初学者可以通过格式化结果直观理解 SQL 语句的层次结构：SELECT 列、FROM 表、WHERE 过滤、GROUP BY 分组、ORDER BY 排序的执行顺序。
技术原理
SQL 格式化器的工作流程包含词法分析（Lexing）和格式化输出两个阶段。词法分析器将 SQL 文本拆分为 Token 序列：关键字（SELECT、FROM、WHERE）、标识符（表名、列名）、操作符（=、>、AND）、字符串字面量等。格式化器遍历 Token 流，根据预定义的规则决定换行和缩进：遇到 SELECT/FROM/WHERE/JOIN/GROUP BY/ORDER BY 等子句关键字时换行并缩进；子查询增加缩进层级；逗号后根据配置换行。
-- 格式化前
select u.name,o.total from users u join orders o on u.id=o.user_id where o.total>100 and u.status='active' order by o.total desc
-- 格式化后
SELECT u.name,
o.total
FROM users u
JOIN orders o ON u.id = o.user_id
WHERE o.total > 100
AND u.status = 'active'
ORDER BY o.total DESC;最佳实践与注意事项
- SQL 关键字统一使用大写（SELECT、FROM、WHERE），与表名列名的小写形成视觉区分。
- 每个子句独占一行，AND/OR 条件缩进对齐，复杂 WHERE 条件更易阅读。
- 子查询和 CASE WHEN 语句增加一级缩进，明确嵌套层级关系。
- 避免过长的单行 SQL，设置合理的最大行宽（通常 80-120 字符），超长列表自动换行。
常见问题
Q：格式化会改变 SQL 的语义吗？
A>不会。格式化工具只修改空白字符（空格、换行、缩进），不改变任何关键字、标识符或操作符。格式化前后的 SQL 在数据库引擎中解析结果完全一致。但如果 SQL 中有语法错误，格式化器可能会报错或输出非预期结果。
Q：支持所有 SQL 方言吗？
A>工具支持标准 SQL 以及 MySQL、PostgreSQL、SQL Server、Oracle、SQLite 等主流方言的语法特性。不同方言特有的关键字和函数（如 MySQL 的 LIMIT、SQL Server 的 TOP）都能正确识别和格式化。
Q：能处理包含注释的 SQL 吗？
A>支持。单行注释（--）和多行注释（/* */）都会被保留在格式化输出中，并保持合理的相对位置。注释不会被误识别为 SQL 关键字或改变格式化逻辑。
Q：如何批量格式化多个 SQL 文件？
A>本工具支持一次粘贴多条 SQL 语句进行格式化。如果需要处理大量 SQL 文件，建议安装命令行格式化工具如 sql-formatter（npm）或 pgFormatter（Perl），通过脚本批量处理。
Q：格式化后 SQL 执行报错了怎么办？
A>格式化本身不会导致错误。如果报错，请检查：原始 SQL 是否本身就有语法错误、字符串中的特殊字符是否在格式化过程中被意外修改、数据库版本是否支持使用的语法特性。对比格式化前后的 Token 数量可以验证完整性。
常见问题
MySQL：支持 LIMIT、SHOW 等专属语法
PostgreSQL：支持 RETURNING、WITH RECURSIVE 等
SQL Server：使用 TOP 代替 LIMIT，WITH (NOLOCK) 等
选择正确的方言可以确保关键词识别准确。