Go语言json包通过结构体标签、指针与零值处理、错误处理及RawMessage实现高效JSON解析与序列化。支持字段映射、omitempty忽略零值、嵌套结构、动态解析等核心功能。

Go 语言内置的 encoding/json 包提供了简洁、高效、安全的 JSON 解析与序列化能力,无需第三方依赖。核心在于理解结构体标签(struct tags)、指针与零值行为、以及错误处理习惯。
定义结构体并映射 JSON 字段
用结构体表示 JSON 数据结构是最常见方式。通过 json: 标签控制字段名映射、是否忽略、是否必须存在等行为:
-
字段名映射:默认按首字母大写的导出字段名匹配,可用
json:"name"显式指定; -
忽略字段:用
json:"-"完全跳过,或json:",omitempty"在值为零值时省略输出; - 嵌套与数组:结构体字段可为其他结构体或切片,自动递归处理。
示例:
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Email string `json:"email,omitempty"` // 空字符串时不输出
Tags []string `json:"tags"`
Meta map[string]interface{} `json:"meta"`
}
将 JSON 字符串解析为 Go 值(Unmarshal)
使用 json.Unmarshal([]byte, &v) 将字节流反序列化到变量。注意传入地址(&v),且目标必须是可寻址的变量。
立即学习“go语言免费学习笔记(深入)”;
- 如果 JSON 字段在结构体中不存在,会被静默忽略;
- 类型不匹配会返回错误(如 JSON 数字写入 string 字段);
- 支持部分解析:结构体只定义需要的字段,其余自动丢弃。
示例:
data := `{"id":123,"name":"Alice","tags":["dev","go"]}`
var u User
err := json.Unmarshal([]byte(data), &u)
if err != nil {
log.Fatal(err)
}
// u.ID == 123, u.Name == "Alice", u.Tags == []string{"dev","go"}
将 Go 值序列化为 JSON 字符串(Marshal)
用 json.Marshal(v) 把 Go 变量转成 JSON 字节切片。输出无空格、紧凑格式;若需缩进美化,用 json.MarshalIndent(v, "", " ")。
- 导出字段(首字母大写)才会被序列化;
-
omitempty标签对零值(0、""、nil、false 等)生效; - 时间、自定义类型需实现
MarshalJSON()方法才能正确转换。
示例:
u := User{ID: 456, Name: "Bob", Tags: []string{"test"}}
b, _ := json.Marshal(u)
// b == {"id":456,"name":"Bob","tags":["test"]}
处理未知或动态 JSON(map[string]interface{} 和 json.RawMessage)
当 JSON 结构不确定或部分嵌套内容需延迟解析时,可用通用类型:
-
map[string]interface{}:适合快速读取任意对象,但需手动类型断言; -
json.RawMessage:延迟解析某字段,避免重复解码,特别适合嵌套 JSON 字符串; - 结合
interface{}+ 类型判断可实现灵活路由逻辑(如不同消息类型共用一个字段)。
示例(延迟解析):
type Event struct {
Type string `json:"type"`
Data json.RawMessage `json:"data"`
}
var e Event
json.Unmarshal(b, &e)
if e.Type == "user_created" {
var u User
json.Unmarshal(e.Data, &u)
// 处理用户数据
}
基本上就这些。熟练掌握结构体标签、零值处理和 RawMessage 的组合,就能应对绝大多数 JSON 场景。










