正确使用结构体标签可实现Go中JSON的灵活序列化与反序列化。1. 通过json:"name"指定字段映射名;2. omitempty在字段为零值时跳过输出;3. -忽略字段;4. 嵌套结构和指针支持自动解引用与null处理;5. 反序列化需字段可导出,标签匹配JSON键名。

在 Go 语言中,encoding/json 包用于处理 JSON 数据的序列化和反序列化。结构体标签(struct tags)是控制 JSON 编码和解码行为的关键。正确使用结构体标签,可以让结构体字段与 JSON 字段之间建立灵活的映射关系。
基本用法:结构体与 JSON 映射
使用
json:标签可以指定结构体字段在 JSON 中的键名。默认情况下,字段名会转为小写作为 JSON 键,但通过标签可以自定义。
例如:
type User struct {
Name string `json:"name"`
Age int `json:"age"`
}
当该结构体被编码为 JSON 时,输出为:
立即学习“go语言免费学习笔记(深入)”;
{"name":"Alice","age":30}标签值写在反引号中,
json:"字段名"指定该字段在 JSON 中的名称。
常用标签选项
结构体标签支持多个选项,用逗号分隔。常见选项包括:
- omitempty:当字段为零值时,不输出到 JSON 中
- -:忽略该字段,不参与序列化和反序列化
- string:将某些类型(如数字、布尔)强制以字符串形式编码
示例:
type Product struct {
ID int `json:"id"`
Name string `json:"product_name"`
Price float64 `json:"price,omitempty"`
IsActive bool `json:"active,omitempty"`
Secret string `json:"-"`
}
如果
Price为 0 或
IsActive为 false,这些字段不会出现在 JSON 输出中。
Secret字段则完全被忽略。
嵌套结构与指针字段处理
结构体可以嵌套,标签规则同样适用。指针字段在编码时会自动解引用,零值指针输出为
null。
例如:
type Address struct {
City string `json:"city"`
Zip string `json:"zip_code"`
}
type Person struct {
Name string `json:"name"`
Addr *Address `json:"address,omitempty"`
}
如果
Addr为 nil,JSON 中不会包含
address字段(因为用了 omitempty)。否则会将其内容序列化为对象。
JSON 反序列化注意事项
从 JSON 解码时,结构体字段必须是可导出的(首字母大写),否则无法赋值。标签用于匹配 JSON 键名。
例如,以下 JSON:
{"name":"Bob","age":25}能正确解码到:
var u User json.Unmarshal(data, &u)
即使 JSON 中的键是小写,只要结构体字段有对应标签或名称匹配,就能正确映射。
基本上就这些。掌握结构体标签的用法,能让你在处理 JSON 时更灵活、更可控。关键是理解标签语法和常见选项的实际效果。不复杂但容易忽略细节。










