应使用 json.rawmessage 延迟解析不确定字段，声明为值类型并检查 len(raw)>0 && json.valid(raw)；对多态结构实现 unmarshaljson 分支解析；避免 map[string]interface{} 高频使用；优先选用 easyjson 或 jsoniter 优化性能。
用 json.RawMessage 延迟解析不确定字段
当 JSON 中某个字段可能为对象、数组、null，或结构随业务动态变化（比如 "data" 有时是 {"id":1}，有时是 [{"id":1},{"id":2}]），硬编码结构体必报错。此时不应强行统一类型，而是用 json.RawMessage 把原始字节暂存下来，等上下文明确后再解析。
常见错误：把 json.RawMessage 声明为 *json.RawMessage 或 string；或未检查其长度就直接传给 json.Unmarshal，导致 panic。
-
json.RawMessage必须是值类型，不能是指针——它本质是[]byte别名，赋值时会复制底层数据 - 解析前务必检查
len(raw) > 0 && json.Valid(raw)，否则空或非法 JSON 会让后续Unmarshal失败 - 适合场景：API 响应中“多态 payload”、配置项支持多种格式、树形节点的
children字段
实现 UnmarshalJSON 处理多态或递归结构
当字段在不同场景下有明确但互斥的结构（例如 "item" 可能是 Product 或 Service），靠运行时判断类型再解析比全用 map[string]interface{} 更可靠、更易测试。
容易踩的坑：在 UnmarshalJSON 方法里直接对 this 调用 json.Unmarshal(b, this)，会触发无限递归；或忽略 json.Number 导致整数精度丢失。
- 先用
json.Unmarshal解到临时map[string]json.RawMessage，再根据 key 存在性/值类型分支处理 - 对时间、数字等敏感字段，优先用
json.Number接收，再转int64或float64，避免浮点截断 - 递归结构（如树节点）必须加深度限制或已访问标记，防止恶意构造的深层嵌套耗尽栈空间
避免 map[string]interface{} 在高频路径上使用
在日志解析、消息总线、实时流处理等场景，用 map[string]interface{} 解析单行 JSON 是性能杀手：每次都要反射遍历、分配 interface{}、做大量类型断言，GC 压力陡增。
实测显示，相同结构下，结构体解析比 map[string]interface{} 快 3–8 倍，内存分配减少 90% 以上。
- 只要字段名和类型相对稳定（哪怕部分可选），就定义结构体 +
json:"field,omitempty" - 对
time.Time字段，直接声明为time.Time并配好time_layout标签，省去后续time.Parse - 若字段名不固定（如指标名动态为 key），用
map[string]YourType替代map[string]interface{}，保留类型安全
用 easyjson 或 jsoniter 替代标准库反射路径
标准库 json.Unmarshal 在 hot path 上（如 HTTP handler）易成瓶颈，CPU 常卡在 reflect.Value.Interface 或 encoding/json.(*encodeState).marshal。
两种主流替代方案适用场景不同：代码生成适合长期维护、结构稳定的项目；drop-in 替代适合快速优化存量服务。
-
easyjson：需运行easyjson -all your_struct.go生成your_struct_easyjson.go，调用YourStruct.UnmarshalJSON()，性能提升 2–5 倍，但要求结构体字段导出性与顺序不变 -
jsoniter：导入替换import json "github.com/json-iterator/go"即可，无需改代码；对interface{}和map的加速有限，强类型 struct 下效果明显 - 注意：
jsoniter.Get()返回的是 view 类型，多次调用.ToString()会重复拷贝字节，应缓存结果
真正难的不是写对一个 JSON 解析，而是让逻辑在字段缺失、类型错位、嵌套过深、超长字符串、非法 Unicode 等边界情况下不 panic、不静默丢数据、错误信息可定位。这些地方往往没日志、没监控、上线后才暴露。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
