# JSON转GraphQL

将JSON数据转换为GraphQL查询格式

> 标准页面: https://elysiatools.com/zh/tools/json-to-graphql

- **分类:** Format Conversion

- **关键词:** json, graphql, 转换, 查询, json转graphql

## 概述

JSON转GraphQL工具能将您的JSON数据快速转换为结构化的GraphQL查询或变更语句。只需输入JSON，设置查询名称和类型，即可自动生成对应的GraphQL代码，省去手动编写的繁琐。

## 输入项

- **JSON输入** (textarea): Enter your JSON data here...
- **查询名称** (text): Enter query name
- **查询类型** (select)

## 适用场景

- 当您拥有现成的JSON数据（如API响应或模拟数据），需要快速生成对应的GraphQL查询时。
- 当您想为前端应用或测试快速原型化一个GraphQL请求，而不想从头手写查询结构时。
- 当您需要将JSON格式的配置或数据转换为GraphQL可查询的格式，以便在支持GraphQL的系统中使用时。

## 工作原理

- 在“JSON输入”文本框中，粘贴或输入您想要转换的JSON数据。
- 在“查询名称”输入框中，为即将生成的GraphQL操作指定一个名称（默认为GetData）。
- 从“查询类型”下拉菜单中选择生成的操作类型：Query（查询）或Mutation（变更）。
- 点击转换按钮，工具将解析JSON结构并输出格式化的GraphQL查询语句。

## 使用案例

- 前端开发：从后端提供的JSON示例数据，快速生成用于获取数据的GraphQL查询，加速开发流程。
- API测试：为测试GraphQL端点，将测试用的JSON负载转换为对应的Mutation或Query，方便构造请求。
- 数据迁移：将旧系统导出的JSON配置或数据，转换为GraphQL查询格式，以便在新系统中进行查询和验证。

## 常见问题

### 这个工具支持哪些JSON结构？

它支持标准的JSON对象和数组。工具会分析JSON的键值对和嵌套结构，将其映射为GraphQL查询中的字段。

### 生成的GraphQL代码可以直接使用吗？

是的，生成的代码是标准的GraphQL语法，可以直接复制到您的项目或API测试工具（如GraphiQL、Postman）中使用。

### 如果我的JSON数据很复杂、嵌套很深怎么办？

工具能够处理多层嵌套的JSON对象和数组，并会相应地生成嵌套的GraphQL字段选择集。

### “查询名称”是必填的吗？

不是必填的。如果不填写，工具会使用默认名称“GetData”。为查询指定一个有意义的名称有助于代码的可读性。

### 我可以将JSON转换为Mutation吗？

可以。在“查询类型”选项中选择“Mutation”，工具就会生成一个GraphQL变更语句，适用于需要修改数据的场景。

## 相关工具

- [BSON转换器](https://elysiatools.com/zh/tools/bson-converter): 将数据编码/解码为BSON（Binary JSON）格式
- [CSON转JSON](https://elysiatools.com/zh/tools/cson-to-json): 将CSON（CoffeeScript对象表示法）数据转换为JSON格式
- [EDN转JSON](https://elysiatools.com/zh/tools/edn-to-json): 将EDN（可扩展数据表示法）数据转换为JSON格式
- [GeoJSON转GPX转换器](https://elysiatools.com/zh/tools/geojson-to-gpx): 将GeoJSON格式转换为GPX（GPS交换格式）格式
- [GeoJSON转KML转换器](https://elysiatools.com/zh/tools/geojson-to-kml): 将GeoJSON格式转换为KML（Keyhole标记语言）格式
- [GeoJSON转OSM转换器](https://elysiatools.com/zh/tools/geojson-to-osm): 将GeoJSON格式转换为OpenStreetMap (OSM) XML格式
- [GPX转GeoJSON转换器](https://elysiatools.com/zh/tools/gpx-to-geojson): 将GPX（GPS交换格式）转换为GeoJSON格式
- [GraphQL转JSON](https://elysiatools.com/zh/tools/graphql-to-json): 将GraphQL查询或响应数据转换为JSON格式

## 示例

- [JSON 示例](https://elysiatools.com/zh/samples/json): JSON（JavaScript 对象表示法）格式示例，从简单到复杂结构
- [Terraform Plan JSON 样本](https://elysiatools.com/zh/samples/terraform-plan-json-samples): 用于依赖可视化和变更审查的 Terraform plan JSON 文件样本，贴近 terraform show -json 输出结构
- [聊天记录 JSON 示例](https://elysiatools.com/zh/samples/chat-transcript-json): 多角色聊天记录的 JSON 示例
- [富媒体 JSON 示例](https://elysiatools.com/zh/samples/rich-media-json): 常见富文本编辑器（TipTap、Quill、Slate）的 JSON 示例

## 相关内容

- [JSON 规范化与数据交换工作流](https://elysiatools.com/zh/hubs/json-convert): 把结构化来源转换为经过核对的 JSON 表示，再按下游需求导出为表格、配置、文档、API、XML、CSON、EDN、BSON 或 UBJSON。