T工具箱
🗄️

SQL 格式化

美化与规范化 SQL 语句

关于此工具

结构化查询语言(SQL)是关系型数据库(如 MySQL、PostgreSQL、Oracle、SQLite)数据检索与操纵的行业标准。然而在生产环境日志、ORM 框架自动生成或历史代码中,SQL 查询语句往往被挤压成冗长混乱的单行文本,包含多层 JOIN 关联、子查询嵌套与繁杂的 WHERE 过滤条件,导致阅读和审查极其困难。本工具提供纯前端本地 SQL 美化与压缩,支持关键字大写规范化、子句换行缩进与语法校验。

如何使用本工具(操作步骤)

1

粘贴未格式化的 SQL 语句

将后端框架打印的日志、ORM 生成的代码或复杂单行查询直接粘贴进编辑框中。

2

选择格式化风格或压缩

点击「格式化」自动将 SELECT、FROM、WHERE、JOIN 等核心关键字大写并按层级缩进;或选择「压缩」合并为单行紧凑文本。

3

检查语法并一键复制

确认层级缩进清晰无误后,点击复制按钮即可粘贴回 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 传输以节省带宽。

相关推荐工具

所有处理都在你的浏览器本地完成,数据不会上传到服务器。
/