Go 的 encoding/json 包要求结构体字段导出（首字母大写）才能解析，非导出字段被静默跳过；需用 json:"key" 标签显式映射，支持蛇形转驼峰但有限制；数组/对象须严格对应切片/struct；空值处理推荐 *T 或 json.RawMessage；混合类型应先用 map[string]json.RawMessage 延迟解析。

Go 的 encoding/json 包能直接将 JSON 映射为结构体，但前提是字段名匹配且导出（首字母大写），否则解析会静默失败或字段为空。

结构体字段必须导出才能被 json.Unmarshal 处理

Go 的反射机制无法访问非导出字段（小写开头），json.Unmarshal 会跳过它们，不报错也不赋值。

• 确保结构体字段首字母大写，例如 UserName 而非 userName
• 用 json 标签显式指定 JSON 键名，大小写无关： UserName string `json:"user_name"`
• 如果 JSON 键是 "user_id"，而结构体字段是 UserID int，不加标签也能解析成功（Go 默认做蛇形转驼峰），但这是有限制的：仅支持简单下划线分隔，不支持多下划线或数字混排（如 "user_id_v2" 不会自动转成 UserIDV2）

处理嵌套对象与切片时，类型必须严格对应

JSON 数组必须映射为 Go 切片（[]T），JSON 对象必须映射为 struct 或 map[string]interface{}；类型错配会导致 json.Unmarshal 返回 invalid character 或 cannot unmarshal object into Go value of type []xxx 类错误。

• 嵌套结构体需定义对应子 struct，不能用 interface{} 除非你后续手动断言
• JSON 中可能缺失的字段，建议用指针类型（如 *string）或加 omitempty 标签避免零值干扰
• 若不确定某字段是对象还是字符串（如某些 API 返回 "data": {} 或 "data": "null"），优先用 json.RawMessage 延迟解析

反序列化空值、null 和缺失字段的差异

JSON 中的 null、字段不存在、空字符串，在 Go 结构体中表现不同，直接影响业务逻辑判断。

• string 字段遇到 JSON null → 解析失败（invalid character 'n' looking for beginning of value），除非字段类型是 *string
• *string 遇到 null → 指针为 nil；遇到缺失字段 → 也是 nil；二者无法区分，需靠业务约定或额外字段标识
• sql.NullString 可区分 Valid == false（null 或缺失）和 Valid == true && String == ""（空字符串），适合对接数据库场景

type User struct {
    ID       int64  `json:"id"`
    Name     string `json:"name"`
    Avatar   *string `json:"avatar,omitempty"`
    Metadata json.RawMessage `json:"metadata"`
}

data := []byte(`{"id": 123, "name": "alice", "avatar": null}`)
var u User
err := json.Unmarshal(data, &u)
// u.Avatar == nil，u.Metadata == json.RawMessage("null") —— 注意：RawMessage 不会解析，保留原始字节

真正麻烦的是混合类型字段（比如某个字段有时是对象、有时是字符串），这时候别硬套 struct，先用 map[string]json.RawMessage 提取再按需解析，否则容易 panic 或丢数据。