Go解析JSON核心是json.Unmarshal和json.Marshal,关键在结构体标签(如omitempty、-、string)、导出字段与指针传参,以及用map[string]interface{}或json.RawMessage处理动态结构。

Go 语言解析 JSON 主要靠标准库 encoding/json,核心是 json.Unmarshal(反序列化)和 json.Marshal(序列化)。关键不在于记函数名,而在于结构体标签(struct tag)、类型匹配和空值处理这三点。
结构体字段必须导出 + 正确使用 json 标签
Go 中只有首字母大写的字段(即导出字段)才能被 json 包访问。如果字段名和 JSON key 不一致,或想忽略某个字段,就得用 json: 标签显式声明:
-
json:"name"—— 字段映射到 JSON 中的"name"键 -
json:"name,omitempty"—— 当字段为零值(如空字符串、0、nil 切片等)时,序列化时跳过该字段 -
json:"-"—— 完全忽略该字段(反/序列化都不处理) -
json:"name,string"—— 把字符串形式的数字(如"123")自动转成 int;反之亦然(需类型支持)
反序列化:json.Unmarshal 要传指针
调用 json.Unmarshal([]byte, &v) 时,第二个参数必须是指向变量的指针。否则数据无法写入目标变量,也不会报错,只是静默失败:
- ✅ 正确:
json.Unmarshal(data, &user) - ❌ 错误:
json.Unmarshal(data, user)(user 是值,修改无效) - 如果目标是 map 或 slice,也得传地址:
json.Unmarshal(data, &m)或json.Unmarshal(data, &s)
处理未知/动态 JSON 用 map[string]interface{} 或 json.RawMessage
当 JSON 结构不确定,或部分字段类型运行时才知,别硬套 struct。两种常用方式:
立即学习“go语言免费学习笔记(深入)”;
- 用
map[string]interface{}解析顶层对象(注意:数字默认转为float64,需手动类型断言) - 对嵌套的“可能变化”字段,定义为
json.RawMessage类型,延迟解析(避免重复解码,也绕过类型校验)
常见坑:空值、零值与omitempty 的配合
omitempty 只判断字段是否为“零值”,不是看它有没有被设置。比如:
-
Age int `json:"age,omitempty"`—— 如果 JSON 没传age,反序列化后Age是 0;但这个 0 在序列化时会被跳过 - 想区分“没传”和“传了 0”,得用指针:
Age *int `json:"age,omitempty"`。此时 nil 表示未传,非 nil 才参与序列化 - 字符串同理:
Name *string可区分空串""和未提供字段
基本上就这些。写多了你会发现,Go 的 JSON 处理很实在——不自动补字段、不模糊转换、不隐藏错误。写清楚结构、标好 tag、传对指针,基本不会翻车。










