商城首页欢迎来到中国正版软件门户

您的位置:首页 >Golang json自定义序列化反序列化教程

Golang json自定义序列化反序列化教程

  发布于2025-09-21 阅读(0)

扫一扫,手机访问

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

Golangencoding/json自定义序列化与反序列化

在 Go 语言中,encoding/json 包提供了标准的 JSON 序列化和反序列化功能。但默认行为有时无法满足业务需求,比如处理时间格式、自定义字段映射、忽略空值逻辑等。这时就需要通过实现特定接口来自定义序列化与反序列化过程。

实现 Marshaler 与 Unmarshaler 接口

要控制某个类型的 JSON 输出和解析行为,可以实现 json.Marshalerjson.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。

若想对指针类型做特殊处理,也可以在指针接收者上实现 MarshalJSONUnmarshalJSON

比如:

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。

基本上就这些。自定义序列化的核心在于理解接口机制和标签用法,配合实际需求灵活调整。
本文转载于:互联网 如有侵犯,请联系zhengruancom@outlook.com删除。
免责声明:正软商城发布此文仅为传递信息,不代表正软商城认同其观点或证实其描述。

热门关注