JSON 转 Go 结构体

使用方法

1. 把 JSON 对象粘贴到 JSON 对象 中。整段文本必须是一个对象，顶层为花括号。
2. 输入 根结构体名称，例如 Product；如需该选项，请勾选 为每个标签添加 omitempty。
3. 查看 检查。绿色表示对象已转换，红色则指出问题所在的位置。
4. 把 Go 代码 复制到带有 package 声明的文件中，或下载为 models.go。

Go 类型如何选择

每个 JSON 值都对应一个能容纳它的 Go 类型。字符串变为 string，true 或 false 变为 bool。encoding/json 的 Unmarshal 规则（英文）决定 JSON 如何被读回这些类型。

• 能放进64位的整数变为 int64。带小数点或指数的数，如1.0、2e3，变为 float64；超出 int64 范围的整数也变为 float64。
• null 变为 any。如果 null 与另一类型的值并列，它就取那个类型，因为 null 不会改变 Go 中另一类型的值。
• 对象变为结构体，列表则取其元素共同的类型。同一列表中的多个对象合并为一个结构体；元素类型不一致的列表变为 []any。
• 空对象变为空结构体，空列表变为 []any。

名称、标签与重名

每个字段的名称取自 JSON 中的名称：各个词连接起来，每个词的首字母大写，因此 user-name 变为 UserName。Go 语言规范（英文）规定，首字母大写的字段名会被导出，这就是首字母要大写的原因。json 标签保留名称的原样，因此读回 JSON 时能匹配同一个键。

两个生成相同 Go 名称的名称会加上数字，例如 AB 和 AB2；名称已被占用的结构体也会加上数字。列表中的项以所在列表的名称命名，因此 products 生成名为 Product 的结构体；无法还原单数形式的名称则加后缀 Item。

• 含有逗号、单个短横线或没有字符的名称不能用作 json 标签，因此工具会指出该键并停止。
• 开启 omitempty 时，每个标签都会加上该选项。工具会把根结构体名称的首字母大写，因此 product 变为 Product。

本工具不做的事

• 它不添加 package 声明或 import。请把代码粘贴到已有自己 package 声明的文件中。
• 它不为可选字段使用指针。JSON 中缺失或为 null 的字段，与值为零值的字段无法区分。
• 它不会把名称改为 Go 常用的缩写形式，因此 id 变为 Id。如果您的代码风格要求 ID，请手动改名。

常见问题