go原生encoding/json解析失败几乎总是因结构体与json层级未对齐：字段必须首字母大写导出、显式添加json:"key"标签，嵌套对象须用具名struct而非匿名嵌入，动态key用map[string]t，混合类型数组用[]json.rawmessage。
Go 原生 encoding/json 完全支持嵌套 JSON，但解析失败几乎总是因为结构体定义和 JSON 层级没对齐，而不是包不给力。
字段必须导出且显式打标签
小写字母开头的字段（如 name、created_at）会被 json.Unmarshal 完全忽略，静默设为零值——这是空字段、空切片最常见原因。
- 所有要参与 JSON 解析的字段名必须首字母大写（如
Name、CreatedAt） - JSON 键名是小写或带下划线（如
user_id、created_at）时，必须用json:"user_id"显式映射 - 别依赖“自动驼峰转换”，Go 不做这种事；
json:"user_id"和字段名UserID之间没有隐式关系
嵌套对象必须用具名 struct，不能靠匿名嵌入
写 Nest Nest `json:"nest"` 是对的；写 Nest struct{ ID string } `json:"nest"` 或直接嵌入 struct{ ID string } 是错的——后者会让 Go 误以为你要把 ID 提升到外层，导致解码时找不到对应 key。
- 每层嵌套都应拆成独立
type，比如type User struct {...}、type Profile struct {...} - 避免在结构体里写
Children []struct{ Name string }，改用Children []ChildItem+type ChildItem struct { Name string `json:"name"` } - 具名类型可测试、可加方法、可复用，匿名 struct 只会让初始化和调试变困难
动态 key 或混合类型数组要用 map[string]interface{} 或 json.RawMessage
当 JSON 里出现 "instances": {"28253266": {...}, "99102": {...}} 这种以任意字符串为 key 的对象，或 [{"type":"user"}, {"type":"admin", "level":5}] 这种数组元素结构不一致的情况，硬塞进 struct 必然失败。
- 动态 key → 用
map[string]SomeType，不是[]struct{}；map[string]interface{}仅用于探查或转发，后续取值需断言，易 panic - 混合类型数组 → 字段声明为
[]json.RawMessage，再遍历每个元素，先读type字段，再按需json.Unmarshal到具体 struct -
json.RawMessage是[]byte别名，不触发解析，零拷贝保留原始字节；不能用于局部变量直接解码，只能作为 struct 字段类型
空对象 {} 和 nil slice 的行为差异很关键
JSON 中的空对象 {"data": {}} 解到 struct 字段会成功，但该字段所有子字段都是零值；解到 map[string]interface{} 得到的是空 map。而 "items": null 和 "items": [] 在 Go 里分别对应 nil slice 和长度为 0 的 slice——这直接影响 len() 判断和后续循环逻辑。
- 如果字段可能为
null，考虑用指针类型（如*[]Item）或interface{}接收，再手动判断 -
omitempty只影响序列化（json.Marshal），不影响反序列化；它不会让json.Unmarshal跳过缺失字段 - 深层嵌套时，某一层只是容器（如
"result"、"payload"）且无业务含义，可用json:"result" UnmarshalJSON方法自定义跳过该层
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
