GQ

GraphQL 查询格式化

压缩成一行的 query,一键整理成层级结构

按 { } 嵌套层级自动缩进,参数列表 ( ) 保持内联,注释原样保留。适合整理从日志或接口里复制来的压缩查询。


            

如何使用本工具

  1. 粘贴 GraphQL 查询或点「载入示例」。
  2. 选缩进空格数(2 或 4)。
  3. 右侧实时输出格式化后的查询,按花括号层级缩进。
  4. 复制整理好的查询,粘贴到 GraphiQL、Apollo Studio 或代码里。

常见问题

Q:支持哪些 GraphQL 语法?

A:支持 query、mutation、subscription、fragment、字段、参数、变量、指令、别名、内联片段、列表与注释。工具按花括号层级和标点规则排版,覆盖日常查询的绝大多数写法。

Q:格式化会改变查询语义吗?

A:不会。工具只调整空白、缩进和换行,不改动字段名、参数、变量、字符串字面量的内容。格式化前后的查询在 GraphQL 服务端执行结果完全一致。

Q:字符串里的花括号会被误处理吗?

A:不会。工具在分词阶段把双引号包裹的字符串(含转义引号)当作整体 token,字符串内部的花括号、冒号、逗号都不会被当成结构标点。

Q:参数为什么保持在一行?

A:参数列表在小括号内,通常较短,保持内联更易读。字段层级才换行缩进。如果你习惯参数也换行,目前工具不支持,可以手动调整。

Q:# 注释会被保留吗?

A:会。以 # 开头的行注释会原样保留,并放在对应层级。工具不解析注释内容,只按位置输出。

Q:数据会上传吗?

A:不会。格式化全在浏览器本地完成,没有任何网络请求。