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 结构体中表现不同，直接影响业务逻辑判断。
立即学习“go语言免费学习笔记（深入）”；
-
string字段遇到 JSONnull→ 解析失败（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 或丢数据。
