GraphQL格式化器

GraphQL 查询语言语法灵活：逗号可有可无、空白无关紧要，这让手写的查询容易变得凌乱。格式化后按 2 空格缩进、每字段一行的结构更利于 Code Review 与 Diff；而发给服务端的请求体往往希望尽量小，压缩模式可以去掉全部多余空白与注释。本工具按标准 GraphQL 词法（字符串、块字符串、注释、变量、指令、片段展开）解析后重排，不联网、不上传。

典型应用场景

• 整理从浏览器 DevTools / 抓包工具复制出来的单行 GraphQL 请求
• 把压扁的查询压缩成单行，嵌入测试代码或 curl 命令
• Code Review 前统一团队 GraphQL 查询的排版风格
• 排查查询语法问题：括号不匹配、字符串未闭合会定位到行号

常见问题

• 注释会被保留吗？格式化模式完整保留 # 注释；压缩模式会移除注释（注释对服务端执行无意义）。
• 支持 schema 语言（SDL）吗？主要面向查询语句（query/mutation/subscription/fragment）；SDL 中的 type/enum 定义通常也能被正确缩进，但字段描述字符串建议使用块字符串。
• 参数什么时候会换行？当参数整体超过 60 字符或内部包含注释时，每个参数会独占一行并按括号层级对齐。