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

使用 Go 语言解析 JSON 数组

心靈之曲

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

原创

308人浏览过

使用 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 对象。

使用JSON进行网络数据交换传输中文WORD版

本文档主要讲述的是使用JSON进行网络数据交换传输；JSON（JavaScript ObjectNotation）是一种轻量级的数据交换格式，易于阅读和编写，同时也易于机器解析和生成，非常适合于服务器与客户端的交互。JSON采用与编程语言无关的文本格式，但是也使用了类C语言的习惯，这些特性使JSON成为理想的数据交换格式。和 XML 一样，JSON 也是基于纯文本的数据格式。由于 JSON 天生是为 JavaScript 准备的，因此，JSON的数据格式非常简单，您可以用 JSON 传输一个简单的 St

查看详情

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{} 类型来接收这些字段。