JSON向Go结构体轻松无缝转换的秘诀大公开

使用 Go 语言处理 JSON 的终极指南

JSON 基础

JSON（JavaScript 对象表示法）是一种广泛用于数据交换的格式。Go 语言的 json 包提供了方便的方法，可以轻松地在 JSON 数据结构和 Go 结构体之间进行转换。

转换 JSON 数据

使用 json.Marshal() 和 json.Unmarshal() 函数可以在 JSON 数据和 Go 结构体之间进行转换。

• json.Marshal() 将 Go 结构体编码为 JSON 字节流。
• json.Unmarshal() 将 JSON 字节流解码为 Go 结构体。

示例：

type Person struct {
    Name string
    Age  int
}

jsonStr, err := json.Marshal(person)
if err != nil {
    // 处理错误
}

var person Person
err = json.Unmarshal(jsonStr, &person)
if err != nil {
    // 处理错误
}

JSON 编码和解码

json.Encode() 和 json.Decode() 函数用于将 JSON 数据转换为字符串或从字符串解码 JSON 数据。

• json.Encode() 将 Go 结构体编码为 JSON 字符串。
• json.Decode() 将 JSON 字符串解码为 Go 结构体。

JSON 处理技巧

• 使用 JSON 标签： 通过 JSON 标签可以自定义 Go 结构体字段在 JSON 中的名称。
• 使用匿名字段： 处理嵌套 JSON 数据时，可以使用匿名字段将另一个结构体嵌入到当前结构体中。
• 使用指针： 如果希望某个字段可为空，可以在该字段前使用指针类型。
• 使用自定义编码器和解码器： 对于复杂的数据类型（如时间戳、日期），可以实现自定义编码器和解码器进行处理。

复杂数据类型

处理复杂数据类型时，需要自定义编码器和解码器。

示例：

type Timestamp time.Time

func (t Timestamp) MarshalJSON() ([]byte, error) {
    return []byte(strconv.FormatInt(t.Unix(), 10)), nil
}

func (t *Timestamp) UnmarshalJSON(data []byte) error {
    unixTime, err := strconv.ParseInt(string(data), 10, 64)
    if err != nil {
        return err
    }

    *t = Timestamp(time.Unix(unixTime, 0))
    return nil
}

常见问题解答

1. 如何使用 JSON 标签？

type Person struct {
    Name string `json:"full_name"`
    Age  int    `json:"age"`
}

2. 匿名字段如何工作？

type Person struct {
    Name string
    Address struct {
        Street string
        City   string
    }
}

3. 什么时候使用指针？

type Person struct {
    Name *string `json:"name,omitempty"`
}

4. 如何使用自定义编码器和解码器？

type Timestamp time.Time

func (t Timestamp) MarshalJSON() ([]byte, error) { ... }

func (t *Timestamp) UnmarshalJSON(data []byte) error { ... }

5. 如何处理错误？

if err != nil {
    // 处理错误
}

结论

本指南介绍了 Go 语言中 JSON 处理的最佳实践和技巧。通过使用 json 包，你可以轻松地在 JSON 数据和 Go 结构体之间进行转换。如果你遇到任何问题，可以随时查阅 Go 官方文档或其他资源。