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的字段,使用指针或omitemptytag 控制序列化行为例如解析如下 JSON:
{ "id": 123, "user": { "name": "Alice", "tags": ["admin", "dev"], "profile": { "age": 30, "city": "Shanghai" } } }可定义:
立即学习“go语言免费学习笔记(深入)”;
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正确识别。- 结构体字段必须导出(首字母大写),否则会被忽略
- 用
omitemptytag 排除零值字段(如空字符串、0、nil 切片),减小输出体积 - 若需自定义序列化逻辑(如时间格式、敏感字段脱敏),实现
MarshalJSON()方法 - 对大数据量场景,可复用
bytes.Buffer或预分配切片减少内存分配
常见陷阱与优化建议
实际开发中几个高频问题需特别注意:
- JSON 中
null值会导致结构体字段被设为零值——用指针字段(如*string)可区分“未设置”和“空字符串” - 字段名拼写或大小写不一致导致解析失败,务必核对 tag;可用
json.RawMessage延迟解析不确定部分 - 性能敏感场景避免反复
json.Marshal/Unmarshal,考虑复用json.Decoder/Encoder流式处理 - 第三方 JSON 库如
go-json或simdjson-go可提升吞吐量,但需权衡兼容性与维护成本
- 嵌套对象用内嵌结构体,JSON 数组对应切片(










