首页 > Golang > Go教程

GolangJSON自定义序列化反序列化详解

时间：2025-09-28 13:35:43 278浏览收藏

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《Golang json自定义序列化反序列化教程》，聊聊，我们一起来看看吧！

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

Golangencoding/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 格式：

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的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《GolangJSON自定义序列化反序列化详解》文章吧，也可关注golang学习网公众号了解相关技术文章。

golang JSON