Go 中处理 JSON 数组和嵌套对象的核心是合理使用 encoding/json 包配合结构体(struct)或映射(map[string]interface{})。
在 Go 中处理 JSON 数组和嵌套对象,核心是合理使用 encoding/json 包配合结构体(struct)或映射(
map[string]interface{}
用结构体精准解析嵌套 JSON
当 JSON 结构固定且已知时,定义嵌套结构体是最安全、高效的方式。Go 会自动按字段名(或 tag)映射,支持多层嵌套和数组。
json: tag 显式指定字段对应关系,尤其注意大小写(JSON 字段名通常小写,Go 字段需导出即首字母大写)
- 嵌套对象用内嵌结构体,JSON 数组对应切片(
[]T),无需额外标记
- 对可选字段或可能为
null 的字段,使用指针或 omitempty tag 控制序列化行为
例如解析如下 JSON:
{
"id": 123,
"user": {
"name": "Alice",
"tags": ["admin", "dev"],
"profile": {
"a
ge": 30,
"city": "Shanghai"
}
}
}
可定义:
type Response struct {
ID int `json:"id"`
User struct {
Name string `json:"name"`
Tags []string `json:"tags"`
Profile struct {
Age int `json:"age"`
City string `json:"city"`
} `json:"profile"`
} `json:"user"`
}
然后直接 json.Unmarshal(data, &resp) 即可完成解析。
灵活处理动态或不确定结构的 JSON
当字段名不固定、结构可能变化,或仅需读取部分字段时,用 map[string]interface{} 和 []interface{} 更合适,但需手动类型断言。
- 顶层解析为
map[string]interface{},再逐层用类型断言(v.(map[string]interface{}) 或 v.([]interface{}))向下访问
- 注意:JSON 数字默认解析为
float64,整数也要用 int(v.(float64)) 转换
- 推荐封装辅助函数(如
GetStr(m, "a.b.c"))来简化深层路径读取,避免冗长嵌套断言
高效序列化含嵌套和数组的数据
序列化方向相反,但原则一致:确保 Go 值能被 json.Marshal 正确识别。
- 结构体字段必须导出(首字母大写),否则会被忽略
- 用
omitempty tag 排除零值字段(如空字符串、0、nil 切片),减小输出体积
- 若需自定义序列化逻辑(如时间格式、敏感字段脱敏),实现
MarshalJSON() 方法
- 对大数据量场景,可复用
bytes.Buffer 或预分配切片减少内存分配
常见陷阱与优化建议
实际开发中几个高频问题需特别注意:
- JSON 中
null 值会导致结构体字段被设为零值——用指针字段(如 *string)可区分“未设置”和“空字符串”
- 字段名拼写或大小写不一致导致解析失败,务必核对 tag;可用
json.RawMessage 延迟解析不确定部分
- 性能敏感场景避免反复
json.Marshal/Unmarshal,考虑复用 json.Decoder/Encoder 流式处理
- 第三方 JSON 库如
go-json 或 simdjson-go 可提升吞吐量,但需权衡兼容性与维护成本