使用Go语言解析JSON数组：结构体定义与Unmarshal方法详解-Golang-PHP中文网

使用Go语言解析JSON数组：结构体定义与Unmarshal方法详解

碧海醫心

发布： 2025-10-19 11:56:37

原创

195人浏览过

使用go语言解析json数组：结构体定义与unmarshal方法详解

本文旨在帮助开发者理解如何使用Go语言的`encoding/json`包解析包含JSON数组的复杂JSON数据。通过定义合适的结构体，并结合`json.Unmarshal`方法，我们可以轻松地将JSON数据转换为Go语言中的数据结构，从而方便后续处理和使用。本文将提供结构体定义示例，并着重讲解如何处理JSON数组。

在Go语言中，encoding/json 包提供了 JSON 数据的编码和解码功能。当处理包含 JSON 数组的复杂 JSON 数据时，关键在于定义与 JSON 结构相匹配的 Go 结构体。下面将通过一个实际的例子来说明如何进行操作。

结构体定义

假设我们有如下 JSON 数据：

立即学习“go语言免费学习笔记（深入）”；

{
  "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 结构体。根据 JSON 的层级结构，我们可以定义如下结构体：

type PetFinder struct {
    LastOffset struct {
        T int `json:"$t"`
    } `json:"lastOffset"`
    Pets struct {
        Pet []Pet `json:"pet"`
    } `json:"pets"`
}

type 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,omitempty"` //omitempty表示该字段为空时不进行序列化
    ShelterPetId struct {
        T string `json:"$t"`
    } `json:"shelterPetId,omitempty"`
    Status struct {
        T string `json:"$t"`
    } `json:"status,omitempty"`
    Name struct {
        T string `json:"$t"`
    } `json:"name,omitempty"`
}

登录后复制

代码解释：

即构数智人

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

查看详情

PetFinder 结构体对应于 JSON 数据的根对象。
LastOffset 结构体对应于 lastOffset 字段，其中 $t 字段被映射到 T 字段。
Pets 结构体对应于 pets 字段，其中 pet 字段是一个 JSON 数组，因此在 Go 中使用 []Pet 表示。
Pet 结构体对应于 pet 数组中的每个元素，包含 options 和 breeds 字段。
omitempty tag用于在序列化时忽略空值字段，如果字段为空，则不会包含在JSON输出中。

Unmarshal 方法

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

package main

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

type PetFinder struct {
    LastOffset struct {
        T int `json:"$t"`
    } `json:"lastOffset"`
    Pets struct {
        Pet []Pet `json:"pet"`
    } `json:"pets"`
}

type 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,omitempty"`
    ShelterPetId struct {
        T string `json:"$t"`
    } `json:"shelterPetId,omitempty"`
    Status struct {
        T string `json:"$t"`
    } `json:"status,omitempty"`
    Name struct {
        T string `json:"$t"`
    } `json:"name,omitempty"`
}

func main() {
    jsonData := []byte(`
    {
      "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"
              }
            }
          ]
        }
      }
    }
    `)

    var petFinder PetFinder
    err := json.Unmarshal(jsonData, &petFinder)
    if err != nil {
        log.Fatal(err)
    }

    fmt.Printf("%+v\n", petFinder)

    // 遍历 pets 数组
    for _, pet := range petFinder.Pets.Pet {
        fmt.Printf("Pet Name: %s\n", pet.Name.T)
    }
}

登录后复制

代码解释：

首先，我们将 JSON 数据定义为一个字节数组 jsonData。
然后，我们声明一个 PetFinder 类型的变量 petFinder。
使用 json.Unmarshal 方法将 jsonData 解析到 petFinder 变量中。注意，我们需要传递 petFinder 的指针，以便 json.Unmarshal 方法可以修改其值。
如果解析过程中发生错误，json.Unmarshal 方法会返回一个非空的 error 对象。我们应该检查这个错误，并进行适当的处理。
最后，我们可以通过访问 petFinder 变量的字段来获取解析后的数据。

注意事项