Golang解析JSON：encoding/json库使用教程

本文深入解析 Golang 中 `encoding/json` 库的强大功能，助你轻松玩转 JSON 数据处理。作为 Golang 标准库的重要组成部分，`encoding/json` 提供了高效便捷的 JSON 解析与生成能力。文章详细讲解了如何使用 `json.Unmarshal` 将 JSON 字符串解析为结构体，并通过结构体标签灵活匹配字段名。同时，介绍了 `json.Marshal` 和 `json.MarshalIndent` 将结构体序列化为 JSON 字符串的方法，以及如何利用 `omitempty` 标签忽略空值字段。此外，还探讨了处理不确定结构 JSON 数据的技巧，以及通过实现 `json.Marshaler` 和 `json.Unmarshaler` 接口自定义序列化和反序列化行为的高级用法。掌握这些关键要点，让你在 Golang 项目中高效地处理 JSON 数据，提升开发效率。

Golang 的 encoding/json 库可用于解析和生成 JSON 数据。1. 使用 json.Unmarshal 可将 JSON 字符串解析为结构体，结构体字段需可导出并可通过标签匹配字段名。2. 使用 json.Marshal 或 json.MarshalIndent 可将结构体序列化为 JSON 字符串，通过 omitempty 标签可忽略空值字段。3. 对于不确定结构的 JSON 数据，可用 map[string]interface{} 接收，访问时需进行类型断言。4. 通过实现 json.Marshaler 和 json.Unmarshaler 接口可自定义序列化和反序列化行为。掌握这些要点有助于高效处理 JSON 数据。

在处理 JSON 数据时，Golang 的 encoding/json 标准库是一个非常实用的工具。它提供了对 JSON 的解析与生成能力，使用起来也很直观。

1. 解析 JSON 字符串到结构体

当你拿到一段 JSON 字符串，并希望将其转换为 Go 中的结构体时，可以使用 json.Unmarshal 方法。

举个例子：

package main

import (
    "encoding/json"
    "fmt"
)

type User struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
}

func main() {
    data := `{"name": "Tom", "age": 25}`
    var user User
    err := json.Unmarshal([]byte(data), &user)
    if err != nil {
        fmt.Println("解析失败:", err)
        return
    }
    fmt.Printf("%+v\n", user)
}

几点注意：

• 结构体字段需要是可导出的（首字母大写）
• 使用结构体标签（如 json:"name"）可以指定 JSON 字段名
• 如果 JSON 中有额外字段而结构体没有对应字段，不会报错

2. 将结构体序列化成 JSON 字符串

反过来，如果你想把一个结构体转成 JSON 字符串，可以用 json.Marshal 或 json.MarshalIndent（后者格式更美观）。

示例代码如下：

user := User{Name: "Jerry", Age: 30}
jsonData, _ := json.Marshal(user)
fmt.Println(string(jsonData))

输出结果是：

{"name":"Jerry","age":30}

如果你希望输出带缩进的格式：

prettyJSON, _ := json.MarshalIndent(user, "", "  ")
fmt.Println(string(prettyJSON))

输出会变成：

{
  "name": "Jerry",
  "age": 30
}

小贴士：

• 如果结构体字段值为空（比如字符串为空、数字为0），默认也会被包含在输出中
• 可以用 omitempty 标签跳过空值字段，例如：json:"name,omitempty"

3. 处理不确定结构的 JSON 数据

有时候你可能不知道 JSON 的具体结构，这时候可以用 map[string]interface{} 或者 interface{} 来接收数据。

比如：

data := `{"name": "Lucy", "active": true, "scores": [90, 85, 92]}`
var result map[string]interface{}
json.Unmarshal([]byte(data), &result)

fmt.Println(result["name"])         // Lucy
fmt.Println(result["scores"])       // [90 85 92]

这种做法比较灵活，但访问嵌套结构或类型判断时要小心：

• 使用类型断言来获取具体类型，例如：scores := v.([]interface{})
• 避免直接操作未判断类型的值，否则容易 panic

4. 自定义 JSON 序列化和反序列化行为

如果默认的行为不能满足需求，你可以让结构体实现 json.Marshaler 和 json.Unmarshaler 接口，自定义处理逻辑。

比如下面这个例子，我们希望时间字段以特定格式存储在 JSON 中：

type MyTime struct {
    Time time.Time
}

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

func (m MyTime) MarshalJSON() ([]byte, error) {
    return []byte("\"" + m.Time.Format("2006-01-02") + "\""), nil
}

这样，在解析和生成 JSON 时就会自动使用你定义的格式。

基本上就这些。Go 的 encoding/json 虽然简单，但在实际开发中非常常用，掌握好基本用法和一些细节，能帮你省不少事。

以上就是《Golang解析JSON：encoding/json库使用教程》的详细内容，更多关于golang,JSON,encoding/json,json.Unmarshal,json.Marshal的资料请关注golang学习网公众号！