使用 Go 语言解析 JSON 数组-Golang-PHP中文网

使用 Go 语言解析 JSON 数组

心靈之曲

发布： 2025-10-17 10:59:32

原创

299人浏览过

使用 go 语言解析 json 数组

本文档旨在指导开发者如何使用 Go 语言的 `encoding/json` 包解析包含 JSON 数组的复杂数据结构。通过定义合适的 Go 结构体，可以将 JSON 数据无缝地反序列化为 Go 对象，方便后续处理。本文将提供示例代码，展示如何处理嵌套的 JSON 数组，并提供注意事项，以确保解析过程的正确性。

定义 Go 结构体

要成功解析 JSON 数据，首先需要定义与 JSON 结构相对应的 Go 结构体。encoding/json 包会根据结构体的字段名和类型，将 JSON 数据映射到 Go 对象。

例如，假设有以下 JSON 数据：

{
  "name": "example",
  "options": [
    {
      "key": "a",
      "value": "b"
    },
    {
      "key": "c",
      "value": "d"
    }
  ]
}

登录后复制

对应的 Go 结构体应如下所示：

type Option struct {
    Key   string `json:"key"`
    Value string `json:"value"`
}

type Data struct {
    Name    string   `json:"name"`
    Options []Option `json:"options"`
}

登录后复制

在上面的代码中，Option 结构体用于表示 JSON 数组 options 中的每个元素。Data 结构体则表示整个 JSON 对象，其中 Options 字段是一个 Option 类型的切片，用于存储解析后的 JSON 数组。

注意 json:"key" 这样的标签，这是 encoding/json 包用来进行字段映射的关键。如果没有标签，默认会尝试匹配字段名（区分大小写）。

反序列化 JSON 数据

定义好 Go 结构体后，就可以使用 json.Unmarshal 函数将 JSON 数据反序列化为 Go 对象。

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

查看详情

package main

import (
    "encoding/json"
    "fmt"
    "log"
)

type Option struct {
    Key   string `json:"key"`
    Value string `json:"value"`
}

type Data struct {
    Name    string   `json:"name"`
    Options []Option `json:"options"`
}

func main() {
    jsonData := []byte(`{
        "name": "example",
        "options": [
          {
            "key": "a",
            "value": "b"
          },
          {
            "key": "c",
            "value": "d"
          }
        ]
      }`)

    var data Data
    err := json.Unmarshal(jsonData, &data)
    if err != nil {
        log.Fatalf("反序列化失败: %v", err)
    }

    fmt.Printf("Name: %s\n", data.Name)
    for _, option := range data.Options {
        fmt.Printf("Key: %s, Value: %s\n", option.Key, option.Value)
    }
}

登录后复制

在上面的代码中，jsonData 变量存储了 JSON 数据的字节切片。json.Unmarshal 函数将 jsonData 反序列化为 Data 类型的对象，并将结果存储在 data 变量中。如果反序列化失败，会返回一个错误。

处理嵌套的 JSON 数组

当 JSON 数据包含嵌套的数组时，需要定义嵌套的 Go 结构体来表示数据的结构。

例如，根据原始问题中的 JSON 数据，可以定义以下 Go 结构体：

type PetFinder struct {
    LastOffset struct {
        T string `json:"$t"`
    } `json:"lastOffset"`
    Pets struct {
        Pet []struct {
            Options struct {
                Option []struct {
                    T string `json:"$t"`
                } `json:"option"`
            } `json:"options"`
            Breeds struct {
                Breed struct {
                    T string `json:"$t"`
                } `json:"breed"`
            } `json:"breeds"`
            ShelterPetId struct {
                T string `json:"$t,omitempty"` //omitempty 表示如果字段为空，则在序列化时忽略该字段
            } `json:"shelterPetId,omitempty"`
            Status struct {
                T string `json:"$t,omitempty"`
            } `json:"status,omitempty"`
            Name struct {
                T string `json:"$t,omitempty"`
            } `json:"name,omitempty"`
        } `json:"pet"`
    } `json:"pets"`
}

登录后复制

这个结构体反映了 JSON 数据的嵌套结构，可以用于反序列化复杂的数据。注意omitempty标签的使用，可以避免序列化时输出空值。

注意事项

字段名匹配： encoding/json 包会根据结构体字段名和 JSON 字段名进行匹配。确保字段名的大小写和拼写一致。可以使用 json 标签来指定 JSON 字段名。
错误处理： json.Unmarshal 函数可能会返回错误。务必检查错误并进行适当的处理。
数据类型： 确保 Go 结构体字段的类型与 JSON 数据的类型匹配。例如，JSON 字符串应映射到 Go 的 string 类型，JSON 数字应映射到 Go 的 int 或 float64 类型。
JSON 标签： 使用 JSON 标签可以更灵活地控制字段的映射关系。例如，可以使用 - 标签忽略某个字段，使用 omitempty 标签在序列化时忽略空值。
处理未知字段： 如果 JSON 数据包含 Go 结构体中未定义的字段，json.Unmarshal 函数会忽略这些字段。如果需要处理未知字段，可以使用 map[string]interface{} 类型来接收这些字段。