Go语言中处理嵌套JSON数据：结构体与Unmarshal实践-Golang-PHP中文网

Go语言中处理嵌套JSON数据：结构体与Unmarshal实践

聖光之護

发布： 2025-11-01 14:34:01

原创

250人浏览过

Go语言中处理嵌套JSON数据：结构体与Unmarshal实践

本教程详细介绍了如何在go语言中高效处理包含嵌套数组和对象的json数据。通过定义符合json结构的go语言结构体（struct），并利用`encoding/json`包进行数据解组（unmarshal），文章演示了如何遍历并访问深层嵌套的数据，为go开发者提供了清晰的json数据解析指南。

在Go语言中处理复杂的JSON数据是常见的任务，特别是当JSON结构包含多层嵌套的数组和对象时。理解如何正确地将这些数据解组（Unmarshal）到Go语言的结构体中，并有效地访问它们，是Go开发者的基本技能。本教程将以一个具体的嵌套JSON示例为基础，详细讲解这一过程。

1. JSON数据结构分析

首先，我们来审视待处理的JSON数据：

{
    "series": [
        {
            "series_id": "PET.EMD_EPD2D_PTE_NUS_DPG.W",
            "name": "U.S. No 2 Diesel Retail Prices, Weekly",
            "units": "Dollars per Gallon",
            "updated": "2013-09-27T07:21:57-0400",
            "data": [
                [
                    "20130923",
                    "3.949"
                ],
                [
                    "20130916",
                    "3.974"
                ]
            ]
        }
    ]
}

登录后复制

从结构上看，这是一个顶层对象，包含一个名为series的键。series的值是一个数组，数组中的每个元素又是一个对象。这些内部对象包含series_id、name、units、updated等字段，以及一个名为data的字段。data字段的值是一个二维字符串数组，其中每个内部数组包含两个字符串（例如日期和价格）。

2. 设计Go语言结构体

为了将上述JSON数据解组到Go中，我们需要设计一系列相互关联的Go结构体，以精确映射JSON的层级结构。

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

Series 结构体： 对应JSON中series数组的每个元素对象。
RawFuelPrice 结构体： 对应顶层JSON对象，包含series数组。

package main

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

// Series 结构体映射JSON中 "series" 数组的每个元素对象
type Series struct {
    SeriesID string `json:"series_id"` // 使用json tag映射JSON字段名
    Name     string `json:"name"`
    Units    string `json:"units"`
    Updated  string `json:"updated"`
    Data     [][]string `json:"data"` // 二维字符串数组，精确匹配JSON中的data结构
}

// RawFuelPrice 结构体映射顶层JSON对象
type RawFuelPrice struct {
    Series []Series `json:"series"` // 包含一个Series结构体切片
}

登录后复制

关键点说明：

json:"fieldName" Tag: Go结构体字段的命名约定是驼峰式（例如SeriesID），而JSON字段通常是下划线分隔（例如series_id）。使用json:"fieldName"标签可以告诉encoding/json包如何将JSON字段映射到Go结构体字段。
Data [][]string: 这是处理二维数组的关键。JSON中的data字段是一个包含多个数组的数组，每个内部数组又包含字符串。因此，[][]string是其在Go中对应的正确类型。尝试使用如Data []interface{}[]这样的语法在Go中是无效的。
顶层Data字段的缺失： 原始JSON数据中并没有一个名为Data的顶层字段，因此在RawFuelPrice结构体中不需要定义它。

3. 解组JSON数据

有了匹配的结构体定义后，我们可以使用json.Unmarshal函数将JSON字符串解析到RawFuelPrice结构体实例中。

func main() {
    jsonData := []byte(`{
        "series": [
            {
                "series_id": "PET.EMD_EPD2D_PTE_NUS_DPG.W",
                "name": "U.S. No 2 Diesel Retail Prices, Weekly",
                "units": "Dollars per Gallon",
                "updated": "2013-09-27T07:21:57-0400",
                "data": [
                    [
                        "20130923",
                        "3.949"
                    ],
                    [
                        "20130916",
                        "3.974"
                    ]
                ]
            }
        ]
    }`)

    var rfp RawFuelPrice
    err := json.Unmarshal(jsonData, &rfp)
    if err != nil {
        log.Fatalf("Error unmarshaling JSON: %v", err)
    }

    // ... 访问数据的代码将在下一节展示
}

登录后复制

注意事项：

Find JSON Path Online

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

查看详情

json.Unmarshal的第二个参数必须是一个指向结构体变量的指针。
务必进行错误检查，以确保解组过程成功。

4. 访问嵌套数据

一旦JSON数据被成功解组到rfp变量中，我们就可以通过遍历结构体字段来访问其内部的嵌套数据。

// 遍历顶层Series切片
for _, s := range rfp.Series {
    fmt.Println("系列名称:", s.Name)
    fmt.Println("系列ID:", s.SeriesID)
    fmt.Println("单位:", s.Units)
    fmt.Println("更新时间:", s.Updated)

    // 遍历Series内部的Data二维数组
    for _, d := range s.Data {
        if len(d) >= 2 { // 确保内部数组有足够的元素
            date := d[0]
            price := d[1]
            fmt.Printf("\t日期: %s, 价格: %s\n", date, price)

            // 根据特定日期查找价格的示例
            if date == "20130923" {
                // fuelPrice.Price = price // 实际应用中可以赋值给其他结构体
                fmt.Printf("\t\t找到特定日期 %s 的价格: %s\n", date, price)
            }
        } else {
            fmt.Println("\t警告: Data数组中的元素不足两个:", d)
        }
    }
    fmt.Println() // 每个系列数据之间添加空行以便阅读
}

登录后复制

这里我们使用了嵌套的for...range循环。外层循环遍历rfp.Series切片，每次迭代得到一个Series结构体实例。内层循环则遍历当前Series实例中的Data二维字符串切片，每次迭代得到一个[]string（即一个日期-价格对）。通过d[0]和d[1]即可访问日期和价格字符串。

5. 完整示例代码

将上述所有部分整合，构成一个完整的Go程序：

package main

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

// Series 结构体映射JSON中 "series" 数组的每个元素对象
type Series struct {
    SeriesID string `json:"series_id"` // 使用json tag映射JSON字段名
    Name     string `json:"name"`
    Units    string `json:"units"`
    Updated  string `json:"updated"`
    Data     [][]string `json:"data"` // 二维字符串数组，精确匹配JSON中的data结构
}

// RawFuelPrice 结构体映射顶层JSON对象
type RawFuelPrice struct {
    Series []Series `json:"series"` // 包含一个Series结构体切片
}

func main() {
    jsonData := []byte(`{
        "series": [
            {
                "series_id": "PET.EMD_EPD2D_PTE_NUS_DPG.W",
                "name": "U.S. No 2 Diesel Retail Prices, Weekly",
                "units": "Dollars per Gallon",
                "updated": "2013-09-27T07:21:57-0400",
                "data": [
                    [
                        "20130923",
                        "3.949"
                    ],
                    [
                        "20130916",
                        "3.974"
                    ]
                ]
            }
        ]
    }`)

    var rfp RawFuelPrice
    err := json.Unmarshal(jsonData, &rfp)
    if err != nil {
        log.Fatalf("Error unmarshaling JSON: %v", err)
    }

    // 遍历顶层Series切片
    for _, s := range rfp.Series {
        fmt.Println("系列名称:", s.Name)
        fmt.Println("系列ID:", s.SeriesID)
        fmt.Println("单位:", s.Units)
        fmt.Println("更新时间:", s.Updated)

        // 遍历Series内部的Data二维数组
        for _, d := range s.Data {
            if len(d) >= 2 { // 确保内部数组有足够的元素
                date := d[0]
                price := d[1]
                fmt.Printf("\t日期: %s, 价格: %s\n", date, price)

                // 根据特定日期查找价格的示例
                if date == "20130923" {
                    fmt.Printf("\t\t找到特定日期 %s 的价格: %s\n", date, price)
                }
            } else {
                fmt.Println("\t警告: Data数组中的元素不足两个:", d)
            }
        }
        fmt.Println() // 每个系列数据之间添加空行以便阅读
    }
}

登录后复制