使用 Go 语言解析 JSON 数组：结构体定义与实践-Golang-PHP中文网

使用 Go 语言解析 JSON 数组：结构体定义与实践

聖光之護

发布： 2025-10-16 11:55:24

原创

407人浏览过

使用 go 语言解析 json 数组：结构体定义与实践

本文档旨在指导开发者如何使用 Go 语言的 `encoding/json` 包解析包含 JSON 数组的复杂 JSON 数据。我们将通过示例代码展示如何定义合适的结构体，以及如何使用 `json.Unmarshal` 函数将 JSON 数据映射到 Go 结构体中，从而方便地访问和处理数据。

在 Go 语言中，解析 JSON 数据是一项常见的任务，特别是当与 Web API 交互时。encoding/json 包提供了强大的功能，可以将 JSON 数据解码（Unmarshal）到 Go 结构体中。当 JSON 数据包含数组时，正确定义 Go 结构体至关重要。本文将通过示例详细介绍如何处理这种情况。

定义 Go 结构体

要正确解析 JSON 数据，首先需要定义与 JSON 结构相匹配的 Go 结构体。JSON 对象的每个字段都应在 Go 结构体中有一个对应的字段。对于 JSON 数组，Go 结构体中的对应字段应为切片（slice）。

考虑以下 JSON 示例：

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

登录后复制

为了解析上述 JSON 数据，可以定义以下 Go 结构体：

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

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

登录后复制

在这个例子中，Option 结构体用于表示 options 数组中的每个对象，而 Data 结构体包含一个 Name 字段（字符串类型）和一个 Options 字段（Option 结构体的切片）。 json:"key" 这样的 tag 用于指定 JSON 字段与 Go 结构体字段之间的映射关系。

解析 JSON 数据

定义好 Go 结构体后，就可以使用 json.Unmarshal 函数将 JSON 数据解析到结构体中。

即构数智人

即构数智人是由即构科技推出的AI虚拟数字人视频创作平台，支持数字人形象定制、短视频创作、数字人直播等。

查看详情

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"
        },
        {
            "key": "e",
            "value": "f"
        }
        ]
    }`)

    var data Data
    err := json.Unmarshal(jsonData, &data)
    if err != nil {
        log.Fatalf("Error unmarshalling JSON: %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 函数接受两个参数：JSON 数据（字节切片）和一个指向要填充的结构体的指针。如果解析成功，data 变量将包含从 JSON 数据中提取的值。如果解析失败，err 变量将包含错误信息。

处理复杂 JSON 结构

实际应用中，JSON 结构可能更复杂，包含多层嵌套的数组和对象。在这种情况下，需要相应地定义 Go 结构体，确保每个 JSON 字段都有对应的 Go 字段。

例如，考虑以下 JSON 结构：

{
  "petfinder": {
    "lastOffset": {
      "$t": 5
    },
    "pets": {
      "pet": [
        {
          "options": {
            "option": [
              {
                "$t": "altered"
              },
              {
                "$t": "hasShots"
              },
              {
                "$t": "housebroken"
              }
            ]
          },
          "breeds": {
            "breed": {
              "$t": "Dachshund"
            }
          }
        },
        {
          "options": {
            "option": {
              "$t": "hasShots"
            }
          },
          "breeds": {
            "breed": {
              "$t": "American Staffordshire Terrier"
            }
          },
          "shelterPetId": {
            "$t": "13-0164"
          },
          "status": {
            "$t": "A"
          },
          "name": {
            "$t": "HAUS"
          }
        }
      ]
    }
  }
}

登录后复制

为了解析这种 JSON 结构，需要定义如下 Go 结构体：

type PetFinder struct {
    LastOffset LastOffset `json:"lastOffset"`
    Pets       Pets       `json:"pets"`
}

type LastOffset struct {
    T int `json:"$t"`
}

type Pets struct {
    Pet []Pet `json:"pet"`
}

type Pet struct {
    Options     Options     `json:"options"`
    Breeds      Breeds      `json:"breeds"`
    ShelterPetId ShelterPetId `json:"shelterPetId,omitempty"`
    Status      Status      `json:"status,omitempty"`
    Name        Name        `json:"name,omitempty"`
}

type Options struct {
    Option []OptionValue `json:"option"`
}

type OptionValue struct {
    T string `json:"$t"`
}

type Breeds struct {
    Breed BreedValue `json:"breed"`
}

type BreedValue struct {
    T string `json:"$t"`
}

type ShelterPetId struct {
    T string `json:"$t"`
}

type Status struct {
    T string `json:"$t"`
}

type Name struct {
    T string `json:"$t"`
}

登录后复制

请注意，这里使用了 omitempty tag，表示如果 JSON 中不存在对应的字段，则忽略该字段。

注意事项

结构体字段名与 JSON 字段名匹配： 确保 Go 结构体字段名与 JSON 字段名匹配，或者使用 json tag 进行映射。
错误处理： 始终检查 json.Unmarshal 函数返回的错误，并进行适当的处理。
数据类型： 确保 Go 字段的数据类型与 JSON 字段的数据类型兼容。
复杂结构： 对于复杂的 JSON 结构，逐步构建 Go 结构体，并逐层解析数据。

总结

本文介绍了如何使用 Go 语言的 encoding/json 包解析包含 JSON 数组的 JSON 数据。通过定义与 JSON 结构匹配的 Go 结构体，并使用 json.Unmarshal 函数，可以方便地将 JSON 数据映射到 Go 结构体中，从而方便地访问和处理数据。在处理复杂的 JSON 结构时，需要仔细定义 Go 结构体，并注意错误处理。

以上就是使用 Go 语言解析 JSON 数组：结构体定义与实践的详细内容，更多请关注php中文网其它相关文章！