json.Unmarshal静默失败主因是字段未导出（首字母小写）或标签/类型不匹配；需确保字段大写、标签一致、慎用interface{}；嵌套动态JSON宜用map[string]json.RawMessage或指针类型。
为什么 json.Unmarshal 会静默失败或返回 nil 错误？
常见现象是结构体字段没被赋值，但 json.Unmarshal 返回 nil，让人误以为解析成功。根本原因是 Go 的 JSON 包只对导出字段（首字母大写）生效，且字段标签不匹配、类型不兼容时会跳过而非报错。
- 确保结构体字段首字母大写，例如
type User struct { Name string `json:"name"` } - 检查 JSON 字段名与
json:标签是否一致，注意大小写和下划线（如"user_id"对应UserID int `json:"user_id"`） - 避免用
interface{}接收后反复断言；若不确定结构，先用map[string]interface{}或json.RawMessage延迟解析 - 空 JSON 对象
{}解析到指针字段时不会初始化该指针，需手动判断== nil
如何安全处理嵌套、可选或动态键名的 JSON？
当 API 返回结构不稳定（比如字段可能缺失、类型混用、键名动态生成），硬绑定结构体会频繁 panic 或丢数据。
- 对可选字段，用指针类型（
*string、*int64）或omitempty标签配合零值判断 - 对动态键（如
{"2024-01": {...}, "2024-02": {...}}），定义为map[string]json.RawMessage，后续按需解析每个值 - 嵌套过深时，拆分结构体并用
json.RawMessage暂存中间层，避免一次性解到最底层导致某层失败就全崩 - 别依赖
json:",string"自动字符串转数字——它只对基本类型生效，且在 Go 1.22+ 中对浮点数有精度风险
json.Marshal 输出空对象或字段消失的常见原因
调用 json.Marshal 得到 {} 或缺少预期字段，通常不是逻辑错误，而是序列化规则被忽略。
- 字段未导出（小写开头）：无论有没有 tag，一律忽略
- 字段值为零值且带
omitempty标签（如空字符串""、0、nil切片），会被直接剔除 - 时间字段用
time.Time默认序列化为 RFC3339 字符串，但若结构体字段是*time.Time且为nil，则该字段消失（非报错） - 自定义
MarshalJSON方法返回nil, err时，整个对象序列化失败并返回错误，但若只返回空字节切片[]byte("")，就会塞进一个空值
性能敏感场景下，json.Decoder 和 json.Encoder 比 Unmarshal/Marshal 强在哪？
当处理大 JSON（如日志流、API 批量响应）或需要边读边处理时，直接操作字节切片会内存暴涨、GC 压力大。
立即学习“go语言免费学习笔记（深入）”；
-
json.Decoder可以从io.Reader（如文件、HTTP body、管道）流式解析，不用一次性加载全部内容到内存 - 配合
Decode多次调用，能逐个解析数组元素：for dec.More() { var item MyStruct; dec.Decode(&item) } -
json.Encoder支持写入任意io.Writer，适合构建响应流或拼接大 JSON，避免中间[]byte分配 - 注意：
Decoder默认不校验 UTF-8，若输入含非法编码会静默截断，必要时 wrap 一层bytes.NewReader+ 预检
最易被忽略的是结构体字段的导出性与 JSON tag 的耦合关系——它不像其他语言那样靠注解驱动，而是由 Go 的可见性规则底层控制。一次字段小写，就足以让整条解析链失效，且无编译期提示。
