通过实现Marshaler与Unmarshaler接口及使用结构体标签,可自定义Go中JSON的序列化与反序列化行为,如格式化时间、重命名字段、忽略空值等。

在 Go 语言中,encoding/json 包提供了标准的 JSON 序列化和反序列化功能。但默认行为有时无法满足业务需求,比如处理时间格式、自定义字段映射、忽略空值逻辑等。这时就需要通过实现特定接口来自定义序列化与反序列化过程。
实现 Marshaler 与 Unmarshaler 接口
要控制某个类型的 JSON 输出和解析行为,可以实现 json.Marshaler 和 json.Unmarshaler 接口。
这两个接口定义如下:
type Marshaler interface { MarshalJSON() ([]byte, error)}type Unmarshaler interface { UnmarshalJSON([]byte) error}
例如,我们希望将时间以
"2006-01-02"
格式输出,而不是默认的 RFC3339 格式:
立即学习“go语言免费学习笔记(深入)”;
type CustomDate struct { time.Time}func (cd CustomDate) MarshalJSON() ([]byte, error) { return []byte(fmt.Sprintf(`"%s"`, cd.Time.Format("2006-01-02"))), nil}func (cd *CustomDate) UnmarshalJSON(data []byte) error { // 去掉引号 s := strings.Trim(string(data), `"`) t, err := time.Parse("2006-01-02", s) if err != nil { return err } cd.Time = t return nil}
使用时:
date := CustomDate{Time: time.Now()}jsonBytes, _ := json.Marshal(date)fmt.Println(string(jsonBytes)) // 输出:"2025-04-05"
结构体字段标签(Struct Tags)
通过
json:
标签可以控制字段名、是否忽略、条件性编码等。
重命名字段:
json:"name"
忽略空值:
json:",omitempty"
忽略字段:
json:"-"
同时使用:
json:"age,omitempty"
示例:
type User struct { ID int `json:"id"` Name string `json:"name"` Email string `json:"email,omitempty"` Admin bool `json:"-"`}
当 Email 为空字符串时,序列化结果中不会包含该字段。
嵌套类型与指针处理
如果字段是指针类型,encoding/json 会自动解引用进行序列化。但如果指针为 nil,则输出 null。
若想对指针类型做特殊处理,也可以在指针接收者上实现
MarshalJSON
或
UnmarshalJSON
。
比如:
func (cd *CustomDate) MarshalJSON() ([]byte, error) { if cd == nil { return []byte("null"), nil } return []byte(fmt.Sprintf(`"%s"`, cd.Time.Format("2006-01-02"))), nil}
这样即使字段是
*CustomDate
类型且为 nil,也能安全处理。
处理动态或未知结构
有时候需要处理部分已知、部分动态的数据。可以结合
map[string]interface{}
或
json.RawMessage
使用。
json.RawMessage 能延迟解析某段 JSON 内容,适用于需要按条件解析的场景。
type Message struct { Type string `json:"type"` Payload json.RawMessage `json:"payload"`}
先解析外层结构,再根据 Type 决定如何解析 Payload。
基本上就这些。自定义序列化的核心在于理解接口机制和标签用法,配合实际需求灵活调整。
以上就是Golangencoding/json自定义序列化与反序列化的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1407768.html
微信扫一扫
支付宝扫一扫