结构体标签控制Go中JSON序列化与反序列化行为。1. json:"name"指定字段名映射;2. omitempty在零值时跳过字段;3. -忽略字段;4. string以字符串形式编码数字或布尔值;5. 嵌套与指针字段自动处理,nil指针不输出;6. 反序列化优先匹配标签名,其次字段名(不区分大小写),多余字段忽略。仅导出字段(首字母大写)生效。

在 Go 语言中,encoding/json 包用于处理 JSON 数据的序列化和反序列化。结构体标签(struct tags)是控制字段如何被编码或解码的关键。下面详细介绍其常见用法和标签解析规则。
基本序列化与反序列化
使用 json.Marshal 将 Go 结构体转换为 JSON 字符串,使用 json.Unmarshal 将 JSON 数据解析回结构体。
示例:
type User struct {
Name string `json:"name"`
Age int `json:"age"`
}
user := User{Name: "Alice", Age: 30}
data, _ := json.Marshal(user)
fmt.Println(string(data)) // {"name":"Alice","age":30}
var u User
json.Unmarshal(data, &u)
结构体标签语法:json:"key,options"
结构体字段后的 ``json:"..."`` 是标签,用于定义该字段在 JSON 中的名称和行为。
常见格式:
json:"字段名[,选项]"
常用选项包括:
立即学习“go语言免费学习笔记(深入)”;
- string:将数字或布尔值以字符串形式编码(常用于兼容某些 API)
- omitempty:当字段为零值时,不输出到 JSON 中
- -:忽略该字段,不参与序列化或反序列化
type Product struct {
ID int `json:"id"`
Name string `json:"product_name"`
Price float64 `json:"price,omitempty"`
Secret string `json:"-"`
Count int `json:"count,string"`
}
- ID 映射为 "id"
- Name 输出为 "product_name"
- Price 若为 0,则不会出现在 JSON 中
- Secret 字段完全忽略
- Count 会以字符串形式编码,如 "10"
嵌套结构与指针字段处理
结构体嵌套时,标签同样适用。指针字段在序列化时会自动解引用。
示例:
type Address struct {
City string `json:"city"`
Zip string `json:"zip_code,omitempty"`
}
type Person struct {
Name string `json:"name"`
Address *Address `json:"address,omitempty"`
}
- 如果 Address 为 nil,输出 JSON 中不包含 address 字段
- 若 Address 有值,自动展开其字段
反序列化时的字段匹配规则
json.Unmarshal 会根据标签或字段名匹配 JSON 键。
- 优先使用
json:"xxx"
标签中的名称 - 若无标签,使用字段名(需首字母大写,即导出字段)
- 匹配不区分大小写,但精确匹配优先
- JSON 中多余字段默认被忽略
只有导出字段(字段名首字母大写)才会被 encoding/json 处理。
基本上就这些。结构体标签是 Go 处理 JSON 的核心机制,掌握标签用法能灵活应对各种数据格式需求。










