通过实现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。
基本上就这些。自定义序列化的核心在于理解接口机制和标签用法，配合实际需求灵活调整。
golang json js go 编码 ai 2025 json String NULL 字符串 结构体 指针 接口 指针类型 Struct Interface nil map