Golang JSON序列化反序列化实战教程

Go语言通过encoding/json包实现JSON序列化与反序列化，核心方法为json.Marshal和json.Unmarshal。结构体字段需首字母大写才能导出，使用json标签可自定义字段名、忽略空值（omitempty）或排除字段（-）。处理动态结构时可用map[string]interface{}，解析后数字为float64类型，需类型断言。time.Time默认序列化为RFC3339格式，自定义格式需定义新类型并实现MarshalJSON和UnmarshalJSON方法。JSON数组映射为slice，嵌套对象映射为嵌套结构体或map。正确使用标签、类型和接口可应对大多数JSON场景。

在Go语言开发中，JSON的序列化与反序列化是处理API、配置文件和数据传输的常见需求。Go标准库encoding/json提供了json.Marshal和json.Unmarshal两个核心方法，使用简单但细节丰富。掌握这些细节，能避免常见坑点，提升代码健壮性。

结构体标签控制字段映射

Go结构体字段必须以大写字母开头才能被json包访问。通过json:标签可自定义JSON字段名、控制是否忽略空值等。

例如：

type User struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
    Email string `json:"email,omitempty"`
    Password string `json:"-"`
}

说明：

• json:"id" 将结构体字段ID序列化为"id"
• omitempty 表示当Email为空字符串时，不输出到JSON
• - 忽略Password字段，不参与序列化与反序列化

处理动态或未知结构数据

当JSON结构不确定时，可以使用map[string]interface{}或interface{}接收数据。

示例：

var data map[string]interface{}
err := json.Unmarshal([]byte(jsonStr), &data)
if err != nil {
    log.Fatal(err)
}
fmt.Println(data["name"])

注意：解析后的数字默认为float64类型，字符串为string，布尔为bool，需做类型断言。

时间字段的格式化处理

Go中time.Time默认序列化为RFC3339格式，如"2023-08-15T10:00:00Z"。若需自定义格式（如"2006-01-02"），需使用自定义类型。

例如：

type CustomTime struct {
    time.Time
}

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

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

将该类型用于结构体字段，即可实现自定义时间格式的序列化与反序列化。

处理JSON数组与嵌套结构

JSON数组可直接映射为Go的slice。嵌套对象映射为嵌套结构体或map。

例如：

type Address struct {
    City  string `json:"city"`
    Zip   string `json:"zip"`
}

type User struct {
    Name    string    `json:"name"`
    Addresses []Address `json:"addresses"`
}

只要JSON结构匹配，Unmarshal会自动填充嵌套字段。确保字段类型和标签正确即可。

基本上就这些。掌握结构体标签、interface{}处理动态数据、时间格式化和嵌套结构映射，就能应对大多数JSON场景。关键是理解Marshal和Unmarshal的行为规则，避免类型不匹配和空值处理问题。