关于此工具
结构化查询语言(SQL)是关系型数据库(如 MySQL、PostgreSQL、Oracle、SQLite)数据检索与操纵的行业标准。然而在生产环境日志、ORM 框架自动生成或历史代码中,SQL 查询语句往往被挤压成冗长混乱的单行文本,包含多层 JOIN 关联、子查询嵌套与繁杂的 WHERE 过滤条件,导致阅读和审查极其困难。本工具提供纯前端本地 SQL 美化与压缩,支持关键字大写规范化、子句换行缩进与语法校验。
如何使用本工具(操作步骤)
粘贴未格式化的 SQL 语句
将后端框架打印的日志、ORM 生成的代码或复杂单行查询直接粘贴进编辑框中。
选择格式化风格或压缩
点击「格式化」自动将 SELECT、FROM、WHERE、JOIN 等核心关键字大写并按层级缩进;或选择「压缩」合并为单行紧凑文本。
检查语法并一键复制
确认层级缩进清晰无误后,点击复制按钮即可粘贴回 Navicat、DBeaver、DataGrip 或代码工程中。
支持主流方言关键字大写规范
自动将标准关键字(SELECT、INSERT、UPDATE、DELETE、GROUP BY、HAVING 等)转换为全大写,符合现代团队代码规范。
智能缩进复杂 JOIN 与子查询
对多表关联(LEFT/INNER JOIN)、括号内的子查询以及 CASE WHEN 分支进行清晰的层级缩进,逻辑结构一目了然。
纯本地离线格式化,数据绝对安全
所有文本解析均在浏览器本地 JavaScript 线程中执行,生产环境 SQL 语句中携带的敏感表名、字段名和用户过滤条件绝不外泄。
SQL 排版与性能优化注意事项
- •避免滥用 `SELECT *`:在正式生产代码中,明确写出需要的具体列名。格式化时将各字段分行排列,既能利用数据库覆盖索引,又能避免宽表带来冗余的内存与网络传输浪费。
- •警惕大写转义与特殊保留字冲突:若表名或列名不幸命中了数据库保留字(如 `order`, `group`, `user`),请根据对应方言使用反引号(MySQL ` `)或双引号(PostgreSQL " ")包裹。
- •多条件 WHERE 子句坚持 AND 换行缩进:复杂的复合逻辑判断中,将 AND 和 OR 独立放置在行首并进行层级缩进,能够有效防止逻辑运算符优先级混乱导致的查询偏差。
代码与转换对比示例
混乱单行复杂查询格式化前后对比
select u.id,u.name,o.total_amount from users u left join orders o on u.id=o.user_id where u.status='active' and o.created_at>='2026-01-01' group by u.id order by o.total_amount desc limit 10;SELECT
u.id,
u.name,
o.total_amount
FROM
users u
LEFT JOIN orders o ON u.id = o.user_id
WHERE
u.status = 'active'
AND o.created_at >= '2026-01-01'
GROUP BY
u.id
ORDER BY
o.total_amount DESC
LIMIT 10;* 换行与字段缩进大幅减轻肉眼审查压力,便于快速排查索引覆盖情况。
SQL 编写排版通用规范参考
• 关键字一律大写: SELECT, FROM, WHERE, AND, OR, ORDER BY
• 表名与列名一律小写蛇形: user_account, created_at
• 逗号位于行尾,新字段单独立行在应用代码中务必使用参数化查询(Prepared Statements)或 ORM 占位符传递动态参数,严禁通过字符串直接拼接 SQL 语句,以杜绝 SQL 注入漏洞(SQL Injection)。* 统一的代码风格有助于团队 Code Review 与慢查询排查。
常见问题解答
Q: SQL 格式化支持哪些数据库方言(Dialects)?
A: 通用标准 SQL 规范可完美适用于 MySQL、PostgreSQL、MariaDB、SQLite、Oracle、Microsoft SQL Server 以及各类现代分布式数仓(如 ClickHouse、Snowflake)。
Q: 格式化会不会改变 SQL 语句原有的执行逻辑?
A: 绝对不会。SQL 格式化本质上是只调整空格、制表符、换行符以及保留关键字的大小写,不会增删任何字符、表名或逻辑表达式,执行计划(EXPLAIN)完全一致。
Q: 压缩(Minify)SQL 有什么实际作用?
A: 将多行 SQL 语句剔除冗余注释与换行折叠为一行紧凑字符串,适合嵌入到单行配置文件、环境脚本或通过 HTTP 传输以节省带宽。