Golang encoding/json解析与序列化实践-Golang-PHP中文网

Golang encoding/json解析与序列化实践

P粉602998670

发布： 2025-09-25 09:24:01

原创

517人浏览过

Go语言中encoding/json包通过json.Marshal和json.Unmarshal实现JSON处理，结合结构体标签控制字段映射，支持动态解析与自定义序列化。1. 结构体字段需大写可导出，使用json:"name"指定键名，omitempty忽略空值，-排除字段。2. 动态JSON可用map[string]interface{}解析，但数字默认转为float64，嵌套结构变为map或slice，适用于配置读取但影响类型安全。3. 自定义类型可实现json.Marshaler和json.Unmarshaler接口，如CustomTime统一日期格式“2006-01-02”。4. 常见注意点：nil指针序列化为null；反序列化必须传指针；标签拼写错误导致静默失败；建议标注所有json标签，使用omitempty减少冗余，并对关键字段校验有效性。5. 复杂场景可用json.RawMessage延迟解析。掌握这些技巧可高效处理Web API、配置文件等JSON需求。

golang encoding/json解析与序列化实践

Go语言的encoding/json包为JSON数据的解析与序列化提供了强大且高效的支持。在实际开发中，无论是构建Web API、处理配置文件，还是进行微服务间通信，都离不开对JSON的操作。本文将围绕常用场景，介绍如何正确使用json.Marshal和json.Unmarshal，并分享一些实用技巧。

结构体标签控制字段映射

Go结构体字段通过json:标签控制序列化和反序列化时的键名。这是实现JSON与结构体灵活映射的关键。

例如：

type User struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
    Email string `json:"email,omitempty"` // 空值时忽略
    Password string `json:"-"`            // 不参与序列化
}

登录后复制

说明：

立即学习“go语言免费学习笔记（深入）”；

omitempty表示当字段为空（零值）时不输出到JSON
-用于完全忽略字段
字段必须是大写字母开头（可导出），否则json包无法访问

处理动态或未知结构的JSON

当无法提前定义结构体时，可以使用map[string]interface{}或interface{}来解析任意JSON对象。

示例：

data := `{"name": "Alice", "age": 30, "active": true}`
var v map[string]interface{}
if err := json.Unmarshal([]byte(data), &v); err != nil {
    log.Fatal(err)
}
fmt.Println(v["name"], v["age"])

登录后复制

注意：

Devv

Devv是一个专为程序员打造的新一代AI搜索引擎

140

查看详情

数字类型默认解析为float64，即使原始是整数
嵌套对象会变成嵌套的map或slice
适用于临时解析或配置读取，但应避免在核心逻辑中频繁使用，影响类型安全

自定义序列化行为

某些类型（如时间、枚举、特殊数值）需要定制JSON输出格式。可通过实现json.Marshaler和json.Unmarshaler接口完成。

以时间格式为例：

type CustomTime struct {
    time.Time
}

func (ct *CustomTime) MarshalJSON() ([]byte, error) {
    return []byte(fmt.Sprintf(`"%s"`, ct.Time.Format("2006-01-02"))), nil
}

func (ct *CustomTime) UnmarshalJSON(data []byte) error {
    layout := "2006-01-02"
    parsed, err := time.Parse(layout, strings.Trim(string(data), `"`))
    if err != nil {
        return err
    }
    ct.Time = parsed
    return nil
}

登录后复制

这样可以在结构体中使用CustomTime来统一日期格式，避免前端兼容问题。