Go 中如何将嵌套 JSON 解析为嵌套结构体（Struct）？-Golang-PHP中文网

Go 中如何将嵌套 JSON 解析为嵌套结构体（Struct）？

本文详解如何在 go 中正确解析嵌套 json 数据到多层嵌套的结构体中，涵盖 json 格式规范、结构体字段导出规则、标签映射技巧，以及推荐的流式解码方式，并提供可直接运行的完整示例。

本文详解如何在 go 中正确解析嵌套 json 数据到多层嵌套的结构体中，涵盖 json 格式规范、结构体字段导出规则、标签映射技巧，以及推荐的流式解码方式，并提供可直接运行的完整示例。

在 Go 中将嵌套 JSON 映射为嵌套结构体是常见需求，但初学者常因格式不规范、字段未导出或解码方式不当而失败。核心要点有三：合法 JSON 语法、导出的首字母大写字段、正确的解码流程。下面以一个典型场景为例，逐步说明。

✅ 正确的 JSON 输入格式

原始问题中的 JSON 存在语法错误（缺少引号、键名大小写不一致）。合法 JSON 必须满足：

所有键名和字符串值必须用双引号包裹；
键名需与 Go 结构体字段通过 json tag 或默认规则匹配。

正确示例：

{
  "key1": "val1",
  "key2": "val2",
  "childStruct1": {
    "key3": "val3",
    "key4": "val4"
  },
  "childStruct2": {
    "key5": "val5",
    "key6": "val6"
  }
}

⚠️ 注意：JSON 中的 "childStruct1" 和 "childStruct2" 是小写开头，而 Go 字段需大写导出——json 包默认支持大小写不敏感匹配（如 "key1" → Key1），无需显式 tag，但建议显式声明以增强可维护性。

✅ 正确的 Go 结构体定义

Go 结构体字段必须首字母大写（导出），否则 encoding/json 包无法设置其值。同时，字段类型需与 JSON 值类型一致（如 JSON 字符串对应 string）。

chartjs-reporter

此技能用于在用户需要将结构化数据（查询结果、CSV 摘要、JSON 记录或 Python 字典/列表）转换为独立的 HTML 页面时使用。

下载

type ChildStruct1 struct {
    Key3 string `json:"key3"`
    Key4 string `json:"key4"`
}

type ChildStruct2 struct {
    Key5 string `json:"key5"`
    Key6 string `json:"key6"`
}

type MainStruct struct {
    Key1         string        `json:"key1"`
    Key2         string        `json:"key2"`
    ChildStruct1 ChildStruct1 `json:"childStruct1"`
    ChildStruct2 ChildStruct2 `json:"childStruct2"`
}

✅ 使用 json tag 明确指定映射关系，避免依赖默认行为；
❌ 避免 key3, key4, string 这类非法语法（Go 不支持字段列表简写）。

✅ 推荐的解析方式：流式解码（json.Decoder）

相比一次性读取全部内容再调用 json.Unmarshal，使用 json.NewDecoder 直接从 io.Reader（如文件、HTTP 响应）流式解析更高效、内存友好，且天然支持大型 JSON。

package main

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

func main() {
    f, err := os.Open("jsonData.json")
    if err != nil {
        log.Panicf("failed to open file: %v", err)
    }
    defer f.Close() // 确保文件及时关闭

    var data MainStruct
    if err := json.NewDecoder(f).Decode(&data); err != nil {
        log.Panicf("JSON decode error: %v", err)
    }

    log.Printf("Key1 = %s", data.Key1)
    log.Printf("Full struct: %+v", data)
}

? 关键点说明：

os.Open 返回 *os.File，它实现了 io.Reader，可直接传给 json.NewDecoder；
defer f.Close() 保证文件句柄释放，避免资源泄漏；
使用 log.Panicf 而非 log.Fatalf，确保 defer 语句执行；
若需从字符串解析（如测试），可用 json.Unmarshal([]byte(jsonStr), &data)。

? 常见问题排查

现象	原因	解决方案
字段始终为空（如 "", 0, nil）	字段未导出（小写开头）或类型不匹配	检查字段首字母大写 + 类型一致性
json: cannot unmarshal object into Go struct field ...	JSON 键名与结构体字段无匹配（tag 缺失或拼写错误）	添加 json:"xxx" tag 并核对大小写
panic: runtime error: invalid memory address	传入 nil 指针给 Decode()	确保传入 &data（地址）而非 data（值）