GolangJSON解析与序列化入门教程

大家好，我们又见面了啊~本文《Golang解析JSON与序列化基础教程》的内容中将会涉及到等等。如果你正在学习Golang相关知识，欢迎关注我，以后会给大家带来更多Golang相关文章，希望我们能一起进步！下面就开始本文的正式内容~

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。两种常用方式：

• 用 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、传对指针，基本不会翻车。

理论要掌握，实操不能落！以上关于《GolangJSON解析与序列化入门教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！