Issue
登录
StepCodex FeaturedStepCodex Reviews
Notion Docs

格式化与预览 GraphQL 查询语句 免费在线工具，无需登录、无需注册。

本地运行个人数据安全

Loading Tool Engine

使用说明与技术 FAQ

使用说明

  1. 粘贴原始 GraphQL Query/Mutation。
  2. 查看格式化后的缩进与字段层级是否更清晰。
  3. 根据需要展开/收拢 FAQ，理解输入限制。
  4. 复制结果到你的项目中运行或继续编辑。
  5. 若含多段 operation，确认 `operationName` 与客户端调用一致。
  6. 内省（introspection）超大 schema 时，可先折叠不关心的 type 再阅读。
  7. 与变量一同粘贴时，保持 `variables` JSON 与 schema 类型一致，避免仅格式化 query 却忽略变量形状。
  8. 注释与描述字段（description）在部分工具链会被剥离，提交前确认是否需要保留。
  9. 对比两个版本的 diff 时，可先各自格式化再 diff，减少无关空白干扰。
  10. 若用于 Code Review，可聚焦 selection set 深度与 N+1 查询风险。
  11. 先阅读页面标题与简介，确认当前工具覆盖的场景与你的任务一致（避免用错工具导致理解偏差）。
  12. 在输入区粘贴或键入数据；若页面提供「示例 / 模板」，可先载入再替换为自己的内容以熟悉输出格式。

相关技术知识

  • 格式化通过语法分析将字段与层级重新排版。
  • 输入的变量、别名与嵌套会影响最终结构。
  • 本工具在本地处理，不会发送请求到远端。
  • 如果原始语句不规范，解析可能失败。
  • GraphQL 语法与具体服务端扩展（自定义标量、指令）可能不完全被通用解析覆盖。
  • Fragment 展开与合并属于语义层；格式化只保证语法树可读，不替你优化查询计划。
  • 字段重复、冲突别名等错误有时需结合 schema 才能发现，本工具可能仅做排版。
  • 持久化查询（persisted query）与原始文本不一致时，以服务端注册 hash 为准。
  • 与 gql tag/loader 集成时，注意换行与反引号转义在构建链路中的差异。
  • 安全上，勿在公开渠道粘贴含生产 endpoint 与鉴权头的完整请求。
  • 本类工具的核心解析与计算在浏览器端执行，默认不把原始业务载荷持久化到本站服务器（具体以页面隐私说明为准）。
  • 处理管线通常为：读取输入 → 词法/语法或结构化解析 → 规则变换 → 格式化输出；任一步失败都会尽量给出可定位错误信息。