通过实现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。
基本上就这些。自定义序列化的核心在于理解接口机制和标签用法，配合实际需求灵活调整。
