Golangencoding/json自定义序列化与反序列化-Golang-PHP中文网

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

P粉602998670

发布： 2025-09-20 17:27:01

原创

982人浏览过

通过实现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 格式：

立即学习“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自定义序列化与反序列化的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

Golang HTTP 客户端禁止 URL 转义的实现方法 Golang HTTP 客户端避免 URL 转义如何在 Golang 中查找字符的索引？如何在 Golang 中解析 DNS 数据包：使用第三方库 miekg/dns Golang HTTP 客户端避免 URL 转义的方法