将 JSON 转换为 Go 结构体!

输入 JSON,即可转换为带 json 标签的 Go 结构体!支持 Go (Golang) struct, json tags。
JSON
结果

将 JSON 转换为 Go 结构体!

把 JSON 转换成带有 encoding/json 标签的 Go struct 定义。字段名遵循 Go 的导出命名规则和 golint 的缩写词列表(ID、URL、API 等),各列也像经过 gofmt 一样对齐。

当你需要一个类型来 json.Unmarshal webhook payload 或 API 响应,需要 net/http、Gin 或 Echo 处理函数的请求体 struct,或者 CLI 的配置 struct 时,它都很有用。

使用方法

  1. 粘贴 JSON。如果是包含多行的数组,会检测出在部分行中缺失的字段,并加上 omitempty 标签。
  2. 在 结构体名 中输入顶层 struct 的名称(默认 Root);它会以 ?name= 的形式保留在 URL 中。
  3. 把结果粘贴到 .go 文件中并加上 package 子句。如果发现了时间字段,会包含 import "time"。
  4. 按 var ev WebhookEvent; err := json.Unmarshal(body, &ev) 的方式使用。

示例

输入 (JSON)
{
  "event_id": "evt_1Pq",
  "type": "invoice.paid",
  "created_at": "2024-05-01T03:15:00Z",
  "amount_cents": 4999,
  "customer": { "id": "cus_9", "email": "kim@example.com" },
  "retry_count": null
}
输出 (Go)
import "time"

type WebhookEvent struct {
	EventID     string    `json:"event_id"`
	Type        string    `json:"type"`
	CreatedAt   time.Time `json:"created_at"`
	AmountCents int       `json:"amount_cents"`
	Customer    Customer  `json:"customer"`
	RetryCount  any       `json:"retry_count,omitempty"`
}

type Customer struct {
	ID    string `json:"id"`
	Email string `json:"email"`
}

按照 golint 的缩写词规则,event_id 变成 EventID;RFC 3339 字符串 created_at 被推断为 time.Time,因此添加了 import "time"。retry_count 是 null,类型未知,于是变成带 omitempty 的 any。

支持的功能

  • 每个字段都有 json:"originalKey" 标签,在部分行中缺失或包含 null 的字段还会加上 ,omitempty。
  • 可选的值类型(int、string、bool、struct、time.Time)变成指针(*int),以区分“不存在”和零值。slice 和 any 本身就可以为 nil,保持非指针。
  • 数字:32 位整数为 int,超出则为 int64,出现小数时为 float64。
  • 2024-05-01T03:15:00Z 这样的 RFC 3339 字符串会被推断为 time.Time。
  • 常见缩写词保持大写(user_id → UserID,home_url → HomeURL);以数字开头的 key 会加上 Field 前缀。
  • "" 这类无法出现在 Go json 标签中的 key 会被跳过,并在 struct 上方的注释中列出。
  • 顶层为对象数组时,会生成元素对应的 struct,并附上提示解码到 []Root 的注释。

使用场景

webhook 接收端

根据支付或 Git 托管服务发来的示例事件生成 struct,用 json.NewDecoder(r.Body).Decode(&ev) 解码,而不必对 map[string]any 反复做类型断言。

Gin 或 Echo 中的请求绑定

根据客户端的请求示例生成 c.ShouldBindJSON(&req) 所用的 struct,再在需要的地方加上 binding:"required" 标签。

读取 JSON 配置的 CLI

把 config.json 转成 struct 一次,之后在 os.ReadFile 后调用一次 json.Unmarshal,就能以类型化的值拿到全部配置。

注意事项与限制

  • 只有 RFC 3339 字符串才会被推断为 time.Time;2024-05-01 03:15:00 这样的值或 Unix 时间戳仍是 string 或 int。
  • json.Unmarshal 默认忽略未知 key,并且不区分大小写地匹配 key。需要严格解码时请使用 Decoder.DisallowUnknownFields()。
  • 在 64 位平台上 int 是 64 位的,但只有示例值超过 32 位时才会写成 int64。对于可能增长的 ID,自行改成 int64 更安全。
  • 嵌套的 struct 全部定义为独立的顶层类型,不使用匿名内联 struct。
  • 混合类型的值以及始终为 null 的值会变成 any;知道真实类型后请替换。

常见问题

为什么可选字段是 *int 这样的指针?

普通的 int 字段在 key 缺失时为 0,与真正的 0 无法区分。指针在 key 不存在或为 null 时是 nil,再配合 omitempty,重新 marshal 时就会省略该 key。

能把字段名改成小写吗?

encoding/json 只读写导出的(首字母大写的)字段;小写字段即使有标签也会被忽略。在 Go 中,名称保持大写,JSON key 写在标签里。

retry_count 这样的 null 字段输出成了 any。

示例中只有 null,没有可以推断类型的依据。把另一份带有真实值的响应一起放进数组再转换,或者手动改成 *int 之类的类型。

能把 Go struct 再转回示例 JSON 吗?

能。把 struct 粘贴到顶部的 Go struct → JSON 标签页,它会读取标签并生成示例 JSON。