用结构体标签精准映射字段，结合json.RawMessage延迟解析动态结构，通过嵌套结构体处理复杂嵌套，利用UnmarshalJSON实现多态类型判断，配合错误类型检查与原始数据打印调试，确保JSON解析稳定清晰。
Go 的 encoding/json 包功能强大，但解析嵌套深、字段动态、类型混杂的 JSON 时容易出错。关键不是“能不能解”，而是“怎么解得稳、读得清、改得少”。
用结构体标签精准控制字段映射
JSON 字段名和 Go 字段名不一致、大小写不匹配、字段可选——全靠结构体 tag 控制。
常见写法：
-
`json:"name"`：强制映射到 JSON 中的"name"字段（区分大小写） -
`json:"name,omitempty"`：该字段为空值（""、0、nil、零值切片等）时不参与编码；解码时若缺失也不报错 -
`json:"-"`：完全忽略该字段（既不编码也不解码） -
`json:"name,string"`：把 JSON 中的字符串自动转成 Go 的数字类型（如"123"→int），反之亦然（需类型支持）
注意：omitempty 对指针、接口、map、slice 有效，但对非空值的 bool 或 int 不会跳过——它看的是“零值”，不是“是否设置”。
立即学习“go语言免费学习笔记（深入）”；
处理动态或未知结构的 JSON
当字段名不确定（如配置项 key 是用户自定义）、或同一字段可能为多种类型（比如 "data" 有时是对象，有时是数组），别硬套 struct。
推荐组合方式：
- 先用
json.RawMessage延迟解析：把某字段暂存为原始字节，后续按需再解 - 用
map[string]interface{}或map[string]json.RawMessage解顶层，再分路径判断类型 - 对多态字段，可定义一个中间 wrapper 类型，实现
UnmarshalJSON方法做分支解析
例如：
type Payload struct {
ID int `json:"id"`
Data json.RawMessage `json:"data"`
}
func (p *Payload) GetData() (interface{}, error) {
var obj map[string]interface{}
if err := json.Unmarshal(p.Data, &obj); err == nil {
return obj, nil
}
var arr []interface{}
if err := json.Unmarshal(p.Data, &arr); err == nil {
return arr, nil
}
return nil, errors.New("unsupported data type")
}
嵌套结构与匿名字段的正确展开
嵌套 JSON（如 {"user":{"name":"Alice","profile":{"age":30}}}）建议用内嵌结构体，而非扁平化字段。
正确做法：
- 定义独立子结构体（如
Profile），并在主结构中嵌入或字段引用 - 使用匿名字段嵌入时，tag 仍生效，但要注意字段名冲突（同名字段只保留最外层的）
- 避免过度使用
json:",inline"—— 它会把子结构字段“拍平”到父级，破坏封装且易引发歧义
示例：
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Profile Profile `json:"profile"` // 清晰、可控、可复用
}
type Profile struct {
Age int `json:"age"`
City string `json:"city"`
}
错误处理与调试技巧
解码失败常因类型不匹配、字段缺失、JSON 格式非法。别只写 if err != nil 就 panic。
- 用
json.SyntaxError判断是否为语法问题（可定位行号） - 用
json.UnmarshalTypeError查具体哪个字段、什么类型不匹配 - 临时加个
fmt.Printf("%s", b)打印原始字节，比看 struct 更直观 - 对第三方 API 返回，先用在线工具（如 jsonlint.com）验证格式，再写代码
调试小技巧：把结构体定义和实际 JSON 并排对照，逐字段检查 tag、类型、是否 omitempty、是否指针。
基本上就这些。JSON 解析不复杂，但容易忽略细节。结构体设计 + tag 控制 + 懒解析 + 类型判断，四者配合好，再复杂的 JSON 也能稳稳拿下。
