JSON 转 Go

相关推荐

关于 JSON 转 Go：把 JSON 变成 Go 的强类型 struct

适用场景

• Go 后端开发把 REST API 响应 JSON 转成 struct，直接用 json.Unmarshal 绑定到 Gin/Echo/Fiber handler 的入参
• 前后端联调时拿到 Postman 里的示例响应 JSON，快速生成 Go model 减少手写字段
• 对接第三方 Webhook 回调时，把 payload JSON 转成 Go struct 方便字段级访问与校验
• 把 Viper/Consul/Nacos 里的 JSON 配置文件转成 Go 类型，替代 map[string]interface{} 的弱类型访问
• 微服务团队统一定义 gRPC/HTTP 接口的请求响应结构，把示例 JSON 转成共享的 Go 类型
• 测试工程师把 JSON fixture 转成 Go struct，配合 testify 做断言驱动测试
• 运维人员解析 ELK/Fluentd 收集的 JSON 日志行，生成 struct 后用 Go 程序做结构化分析
• 爬虫抓取到 JSON 数据后转成 Go struct，配合 gorm/gen 或 ent 生成数据库模型
• IoT 设备上报的 JSON 遥测数据转成 Go struct，在边缘网关程序中做反序列化与过滤
• 把 Kafka/NATS/RabbitMQ 消费的 JSON 消息转成 Go 类型，用于事件驱动的消费者实现
• SDK 开发者把服务端示例响应 JSON 转成 Go struct，写入 client 库的 types 包供用户引用
• 把 Swagger/OpenAPI 文档中的示例 JSON 转成 Go struct，作为接口文档代码示例
• 学生或讲师在 Go 课程中把示例 JSON 转成 struct，演示 Go 的类型系统与 json 标签用法
• 数据迁移脚本把 MySQL/PostgreSQL 导出的 JSON 行转成 Go struct，做字段映射与类型校验
• CI/CD 配置 JSON 转 Go struct，方便在 Go 编写的流水线工具里强类型读取配置
• 老项目中把基于 map 动态读取的 JSON 代码重构为基于 struct 的强类型访问

使用方法

1. 在左侧编辑器粘贴 JSON 内容，或拖拽上传 .json/.txt 文件，也可以点击「示例」加载内置数据。
2. 等待约 400ms，工具会自动转换并在右侧显示生成的 Go struct 代码。
3. 如果 JSON 报错，点击「修复 JSON」按钮自动修正常见格式错误后继续生成。
4. 检查右侧输出，点击「复制」粘贴到 Go 项目，或点击「下载」保存为 model.go 文件。

功能特点

• 浏览器本地生成 Go struct：JSON 解析与 Go 代码生成在浏览器内完成，原始数据不上传服务器
• 400ms 防抖自动转换：粘贴或修改后无需手动点击，右侧实时输出可复制的 Go 代码
• 智能类型推断：字符串映射为 string、布尔映射为 bool、整数映射为 int64、浮点映射为 float64、数组映射为切片、对象映射为 struct
• 嵌套对象自动展开：递归生成独立 struct 类型，保持 JSON 层级关系清晰
• 自动生成 json 标签：字段后附带 `json:"原始字段名"` 标签，可直接配合 encoding/json 使用
• JSON 错误一键修复：自动处理尾随逗号、单引号、缺引号等常见格式错误，修复后继续生成
• 支持粘贴/上传/示例三种输入：可拖拽上传 .json/.txt 文件，或加载内置中文示例
• 一键复制与下载：复制整段 Go 代码到剪贴板，或下载为 model.go 文件直接放入项目
• localStorage 输入历史：自动保存最近输入，刷新或误关页面后可快速恢复
• 响应式分屏编辑器：左右面板宽度可调，桌面和移动端都能舒适查看输入与输出

代码示例

package main

import (
    "encoding/json"
    "fmt"
)

// 以下代码由 GeekFormat JSON 转 Go 工具生成
type User struct {
    ID      int64    `json:"id"`
    Name    string   `json:"name"`
    Tags    []string `json:"tags"`
    Address Address  `json:"address"`
}

type Address struct {
    City string `json:"city"`
}

func main() {
    data := []byte(`{
        "id": 1,
        "name": "Alice",
        "tags": ["admin", "dev"],
        "address": {"city": "Beijing"}
    }`)

    var u User
    if err := json.Unmarshal(data, &u); err != nil {
        panic(err)
    }

    fmt.Println(u.Name, u.Address.City)
}

package main

import "encoding/json"

// 手动将字段改为指针，缺失时值为 nil
type User struct {
    ID      *int64  `json:"id,omitempty"`
    Name    *string `json:"name,omitempty"`
    Email   *string `json:"email,omitempty"`
}

func main() {
    data := []byte(`{"id": 1, "name": "Bob"}`)
    var u User
    json.Unmarshal(data, &u)
    if u.Email == nil {
        println("Email 字段缺失")
    }
}

常见问题

故障排查

术语表

struct

Go 的复合数据类型，用于把多个字段组合成一个类型。本工具生成的 Go 代码主体就是若干 struct 定义。

slice

Go 的动态数组类型，语法为 []T。本工具会把 JSON 数组映射为对应的 slice，例如 []string、[]int64、[]UserItem。

json tag

Go struct 字段后的反引号字符串，如 `json:"user_name"`，用于指定 encoding/json 序列化/反序列化时的字段名。本工具会自动生成该标签。

interface{}

Go 的空接口类型，可以表示任意值。本工具在遇到 JSON null 或类型无法确定时，会用 interface{} 作为安全兜底。

PascalCase

每个单词首字母大写的命名风格，如 UserName、AddressCity。Go 要求可导出字段必须以大写字母开头，因此本工具会自动把 JSON 字段名转为 PascalCase。

encoding/json

Go 标准库中的 JSON 编解码包。本工具生成的 struct 配合 json 标签后，可直接用 json.Unmarshal 和 json.Marshal 处理。

unmarshal

把 JSON 字节流解析为 Go 值的过程。生成 struct 后，最常见的用法就是调用 json.Unmarshal(data, &user)。

omitempty

Go json tag 的常用选项，如 `json:"name,omitempty"`，表示字段为零值时省略输出。本工具默认不生成 omitempty，可在生成后按需手动添加。

JSON 类型到 Go 类型映射速查表

本工具根据 JSON 值的类型自动推断对应的 Go 类型，常见映射关系如下：

常见 Go 数字类型选择建议

工具默认使用 int64 和 float64，实际项目中可按需求调整：

Privacy & Security

本 JSON 转 Go 工具的所有处理完全在你的浏览器本地完成：JSON 解析、类型推断、Go 代码生成全部通过 Web Worker 在客户端执行，输入的 JSON 内容、上传的文件以及生成的 Go 代码都不会上传到任何服务器，也不会被记录、缓存或存储到云端。关闭或刷新页面后，所有输入和输出内容自动从内存清除，仅 localStorage 会保留你最近输入的历史记录（可随时清空）。适合处理含 API 密钥、token、敏感业务数据的 JSON。