Go语言JSON解析全攻略

本文深入剖析了Go语言中json.Unmarshal的核心机制与常见陷阱，强调其“写入式”而非“返回式”的设计本质——解析结果直接填充到传入的结构体指针中，错误仅通过error返回；同时系统讲解了结构体字段导出规则、json tag的正确用法、null/缺失/类型不匹配时的容错行为，以及自定义UnmarshalJSON的实现要点和避坑技巧，帮助开发者避开静默失败、零值误用等高频问题，写出健壮可靠的JSON解析代码。

json.Unmarshal 的返回值不是解析结果，而是错误信号

json.Unmarshal 不会把解析好的数据“返回”给你，它只负责把数据写进你传进去的变量里，并告诉你“有没有出错”。它的返回值是 error：等于 nil 表示成功，非 nil 表示失败——仅此而已。

常见错误现象：
• 打印 err 是 nil 就以为“没解析出东西”，其实 p 已被填满，只是你没看它；
• 传了 p 而不是 &p，导致编译通过但解析静默失败（结构体字段全零值）；
• 忘记检查 err，线上 JSON 字段名拼错或类型不匹配时直接用零值继续跑逻辑。

• 必须传指针：json.Unmarshal(data, &p)，否则什么都不会写入
• 解析后立刻验证：fmt.Printf("→ %+v", p)，别只盯着 err
• 调试时可加回写验证：re, _ := json.Marshal(p); fmt.Println(string(re))，确认是否还原一致

结构体字段必须可导出，且注意 json tag 的优先级

Go 的 json 包只处理首字母大写的字段（即“可导出”字段）。小写字母开头的字段，比如 sex string，无论有没有 json:"sex" 标签，都不会被编码或解码。

使用场景：对接外部 API 时，字段名常是 user_id、created_at 这类下划线风格，而 Go 习惯用 UserID、CreatedAt，这时 json tag 就是桥梁。

• 标签优先于字段名：Name string `json:"name"` → JSON 中 key 是 "name"，不是 "Name"
• 字段不可导出 → 完全忽略，不会报错也不会赋值
• 嵌套结构体也一样：内部字段同样要大写 + 合理 tag，否则深层字段丢失

遇到 null、缺失字段或类型不匹配时，Unmarshal 怎么处理

json.Unmarshal 对容错有明确策略：遇到 JSON null，会把对应字段设为 Go 零值（nil 指针、空切片、空 map）；遇到字段缺失，默认不修改目标变量；遇到类型不匹配（比如 JSON 字符串往 int 字段塞），则跳过该字段，继续解析其余部分。

性能 / 兼容性影响：这种“尽力而为”策略让解析不易崩，但也容易掩盖问题——比如后端悄悄改了字段类型，前端没报错，但业务逻辑用了零值。

• 指针字段接收 null → 变成 nil，适合表示“可选”语义
• 普通字段（如 int）收到 null → 保持原值（若未初始化就是 0）
• 想强制校验字段存在？得自己加逻辑，比如解析后检查 p.Name == "" 并报错

需要自定义解析逻辑？实现 UnmarshalJSON 方法

标准 Unmarshal 处理不了的情况：时间格式不统一（"2024-01-01"）、字段需动态计算（"op": "+" → 算出 Result）、或 JSON 结构和 Go 类型不一一对应（比如一个字段有时是字符串、有时是对象）。

这时就得让结构体实现 UnmarshalJSON 方法，但要注意递归陷阱：不能在方法里直接调用 json.Unmarshal(data, &s)，否则无限循环。

• 必须用类型别名绕过：type Alias MyStruct，再对 Alias 解析
• 编译时可加断言确保接口实现：var _ json.Unmarshaler = (*MyStruct)(nil)
• 别忘了处理异常分支：比如时间解析失败要 return error，不能静默吞掉

最常被忽略的一点：json.Unmarshal 是“写入式”操作，它从不返回数据。你真正要关心的，永远是你传进去的那个变量本身，而不是函数返回值。

好了，本文到此结束，带大家了解了《Go语言JSON解析全攻略》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！