结构体标签控制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 Userjson.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 的核心机制,掌握标签用法能灵活应对各种数据格式需求。
以上就是Golang encoding/json用法 结构体标签解析的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1401897.html
微信扫一扫
支付宝扫一扫