Go原生encoding/json解析嵌套JSON最稳路径是严格镜像层级的导出结构体：字段首字母大写、显式json:"key"标签、嵌套对象用独立命名struct、动态key用map[string]T、混型数组用json.RawMessage延迟解析。
Go 原生 encoding/json 完全支持嵌套 JSON 解析，但结构体必须严格镜像 JSON 层级，字段不可导出、标签写错、嵌套方式误用——任一环节出错，都会导致字段为零值（空字符串、0、nil 切片），且不报错。
结构体字段首字母必须大写才能被 json.Unmarshal 读取
小写字母开头的字段（如 name string）对 encoding/json 完全不可见，反序列化时静默跳过，值永远是零值。这不是 bug，是 Go 的导出规则强制要求。
- ✅ 正确：
Name string `json:"name"`（首字母大写 + 显式 tag） - ❌ 错误：
name string `json:"name"`（即使有 tag，也无法赋值） - ⚠️ 注意：嵌套结构体里的字段也必须全部导出，否则内层字段照样为空
嵌套对象必须用命名结构体字段，不能靠匿名嵌入“省事”
json.Unmarshal 不会自动展开或提升嵌套层级。把 Nest Nest `json:"nest"` 写成 Nest `json:"nest"`（缺类型）或直接嵌入 Nest（无字段名），Go 会当成结构体嵌入（embedding），期望 JSON 是 {"id":"123"}，而不是 {"nest":{"id":"123"}} —— 结果就是字段解不出来。
- ✅ 正确：外层定义
Nest Nest `json:"nest"`，再单独定义type Nest struct { ID string `json:"id"` } - ❌ 错误：
Nest struct{ID string} `json:"nest"`（匿名 struct 在嵌套中难以复用、初始化麻烦、易出错） - ⚠️ 混合场景：若某层纯属容器（如
"data"或"payload"），可保留该字段但不拆解，用json:"data"映射到中间结构体，避免过度展开
数组里混着不同结构？用 json.RawMessage 延迟解析
当 JSON 数组元素类型不一致（比如 [{"type":"user","name":"A"},{"type":"admin","level":9}]），直接解到统一 struct 会失败：类型冲突，json: cannot unmarshal object into Go struct field。
立即学习“go语言免费学习笔记（深入）”；
- ✅ 正确：先声明字段为
Items []json.RawMessage `json:"items"`，遍历每个json.RawMessage，再按type字段二次解码 - ⚠️ 关键点：
json.RawMessage是[]byte别名，不触发解析，零拷贝；但它只能作为 struct 字段类型，不能用于局部变量直接json.Unmarshal - ⚠️ 常见坑：把
json.RawMessage当成万能兜底，结果后续反复Unmarshal同一段数据——它本身没状态，可以多次用，但别误以为是“可重读流”
深层嵌套时别硬展开，合理拆分类型比“一层到底”更稳
遇到类似 {"response":{"data":{"list":[{"item":{"id":1}}]}}} 这种四层结构，强行定义 Response.Data.List[0].Item.ID 对应的四级嵌套 struct，会导致类型爆炸、字段难维护、复用性差。
- ✅ 推荐：拆成
type Response struct { Data DataResp `json:"data"` }→type DataResp struct { List []ListItem `json:"list"` }→type ListItem struct { Item ItemDetail `json:"item"` }，每层语义清晰 - ⚠️ 动态场景：若某层 key 名不确定（如返回
{"user_123":{...},"user_456":{...}}），就不用 struct，改用map[string]User - ⚠️ 空对象行为差异：
{}解到 struct 得到全零值；解到map[string]interface{}得到空 map —— 业务逻辑需区分处理
最常被忽略的是：JSON 键名大小写和结构体字段 tag 的严格对应关系。哪怕 JSON 是 "CreatedAt" 而结构体写了 CreatedAt string `json:"created_at"`，只要 tag 匹配不上，字段就为空——而 Go 编译器完全不提示。
