遇到深度嵌套JSON，应先用map[string]interface{}快速探路，再按需用struct+json.RawMessage延迟解析、interface{}+类型断言处理异构数组，性能敏感时选用gjson。
遇到嵌套太深的 JSON，别硬写 struct，先用 map[string]interface{} 快速探路
Go 的 json.Unmarshal 对深度嵌套结构最直接的障碍不是能力不足，而是提前定义 struct 成本太高——字段名不确定、层级动态变化、部分字段可能缺失或类型混杂。这时候强行写 struct 容易卡在“字段名拼错”“某层漏了 json:"xxx" 标签”“某个值其实是 string 但你当成了 float64”上。
建议第一步：用 map[string]interface{} 全量解包，打印看结构：
var data map[string]interface{}
err := json.Unmarshal([]byte(jsonStr), &data)
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", data)
这样能立刻看到键名、嵌套层级、实际类型（interface{} 在运行时是 float64、string、map[string]interface{} 或 []interface{}）。注意：json.Number 默认不会出现，除非你显式启用 UseNumber()。
需要类型安全？用 struct + json.RawMessage 延迟解析中间层
当你确认了顶层结构稳定，但中间某几层仍复杂多变（比如 API 返回中有个 "payload" 字段，内容随业务类型不同而完全不同），就别把整个 payload 展开成 struct。用 json.RawMessage 把它原样存下来，等真正要用时再按需解析：
立即学习“go语言免费学习笔记（深入）”；
type Response struct {
Code int `json:"code"`
Msg string `json:"msg"`
Data json.RawMessage `json:"data"` // 不立即解析
}
var resp Response
json.Unmarshal(b, &resp)
// 后续根据 resp.Code 或其他上下文决定怎么解析 Data
if resp.Code == 200 {
var user User
json.Unmarshal(resp.Data, &user) // 只在这里解析
}
好处是避免为所有可能的 Data 类型提前定义几十个 struct；缺点是少了一层编译期检查，得靠测试覆盖分支逻辑。
嵌套数组里混着不同结构？用 interface{} + 类型断言逐个处理
常见于日志、事件流或聚合接口返回：一个 []interface{} 里既有 map[string]interface{}，又有 string 或 nil。直接转成 struct 切片会 panic。
- 先用
[]interface{}解出数组 - 遍历每个元素，用类型断言判断真实类型：
v, ok := item.(map[string]interface{}) - 对
ok为 true 的做进一步处理，ok为 false 的跳过或报错
示例：
var items []interface{}
json.Unmarshal(b, &items)
for _, item := range items {
if m, ok := item.(map[string]interface{}); ok {
if id, ok := m["id"]; ok {
fmt.Println("ID:", id)
}
}
}
注意：JSON 数字一律被解为 float64，哪怕原始是整数；需要整数时得手动转换：int(id.(float64))。
性能敏感场景下，避免反复 Unmarshal，优先考虑 jsoniter 或 gjson
如果只是读取嵌套 JSON 中几个字段（比如从 10 层深的结构里取 data.items[0].meta.tags[2].name），用标准库 json.Unmarshal 全量解析再层层取值，浪费内存和 CPU。此时 gjson 是更轻量的选择：
result := gjson.GetBytes(b, "data.items.#.meta.tags.#.name")
for _, v := range result.Array() {
fmt.Println(v.String())
}
gjson 不解析整个 JSON，只按路径扫描字节流，适合高吞吐低延迟场景；但它不提供类型安全，所有值都是 gjson.Result，需手动调 .String() / .Int() 等方法。若项目已重度依赖标准库且无性能瓶颈，不必为了“看起来高级”切换。
嵌套越深，越容易在类型断言、空指针、数组越界上栽跟头；与其纠结“怎么一次性写对”，不如分阶段验证：先解顶层，再解子层，每步都加 if err != nil 和 if xxx == nil 检查。没人能一次写对五层嵌套的 struct 标签。
