Go语言JSON解析：Unmarshal函数与结构体映射实战

桃夭

发布时间：2026-10-15| 6人浏览过

原创

本文详解Go语言使用json.Unmarshal解析JSON数据的方法，从基础数组到包含特殊键名的复杂嵌套对象，通过代码示例展示如何利用结构体标签（struct tags）实现精确映射。

基础JSON解析示例

在Go语言中，解析JSON通常涉及两个核心步骤：定义对应的结构体（Struct）和使用 json.Unmarshal 进行反序列化。官方文档提供了标准示例，展示了如何解析包含多个对象的JSON数组。

1. 解析JSON数组（切片）

假设需要解析一个包含动物信息的数组。首先定义结构体，注意结构体字段必须首字母大写以暴露给 encoding/json 包：

package main

import (
	"fmt"
	"encoding/json"
)

type Animal struct {
	Name  string
	Order string
}

func main() {
	var jsonBlob = []byte(`[
		{"Name": "Platypus", "Order": "Monotremata"},
		{"Name": "Quoll",    "Order": "Dasyuromorphia"}
	]`)

	var animals []Animal

	err := json.Unmarshal(jsonBlob, &animals)
	if err != nil {
		fmt.Println("error:", err)
	}
	fmt.Printf("%+v\n", animals)
}

输出结果为：

[{Name:Platypus Order:Monotremata} {Name:Quoll Order:Dasyuromorphia}]

2. 解析单条JSON对象

若JSON数据仅为单个对象，将目标变量定义为结构体实例而非切片即可：

func main() {
	var jsonBlob = []byte(`{"Name": "Platypus", "Order": "Monotremata"}`)
	var animals Animal
	
	err := json.Unmarshal(jsonBlob, &animals)
	if err != nil {
		fmt.Println("error:", err)
	}
	fmt.Printf("%+v\n", animals)
}

输出为：{Name:Platypus Order:Monotremata}

处理复杂结构与特殊字段名

实际开发中，JSON数据往往嵌套较深，且字段名可能包含空格或非标准字符。此时需合理使用指针、切片及 json 标签（Tag）来建立映射关系。

第1步：定义带Tag的结构体

当JSON中的键名与Go结构体字段名不一致，或包含空格时，必须在结构体字段后添加 json:"key_name" 标签。对于不需要修改的嵌套对象，建议使用指针类型以节省内存并提高灵活性；对于动态数量的列表数据，使用切片（Slice）。

以下示例展示了一个包含水果详情和数组的复杂JSON结构：

type Fruit struct {
	Describe string `json:"describe"`
	Icon     string `json:"icon"`
	Name     string `json:"name"`
}

type FruitGroup struct {
	FirstFruit    *Fruit   `json:"first fruit"`
	SecondFruit   *Fruit   `json:"second fruit"`
	ThreeFruitArray []string `json:"three fruit array"`
}

第2步：执行Unmarshal操作

将上述结构体应用于实际JSON数据的解析。注意JSON中的键名如 "first fruit" 包含空格，必须严格匹配Tag中的值。

func main() {
	var jsonBlob = []byte(`{
    "first fruit": {
        "describe": "an apple",
        "icon": "appleIcon",
        "name": "apple"
    },
    "second fruit": {
        "describe": "an orange",
        "icon": "appleIcon",
        "name": "orange"
    },
    "three fruit array": [
        "eat 0",
        "eat 1",
        "eat 2",
        "eat 3"
    ]}`)

	var fruitGroup FruitGroup
	
	err := json.Unmarshal(jsonBlob, &fruitGroup)
	if err != nil {
		fmt.Println("error:", err)
	}
	
	// 验证结果
	fmt.Printf("%+v\n", fruitGroup)
	if fruitGroup.FirstFruit != nil {
		fmt.Printf("First: %+v\n", fruitGroup.FirstFruit)
	}
	if fruitGroup.SecondFruit != nil {
		fmt.Printf("Second: %+v\n", fruitGroup.SecondFruit)
	}
}

第3步：理解解析结果

运行上述代码，控制台输出如下：

{FirstFruit:0xc00006c5a0 SecondFruit:0xc00006c5d0 ThreeFruitArray:[eat 0 eat 1 eat 2 eat 3]}
&{Describe:an apple Icon:appleIcon Name:apple}
&{Describe:an orange Icon:appleIcon Name:orange}

解析要点说明：

指针引用：第一层结构体 FruitGroup 中的子对象使用了 *Fruit 指针。这表示它们指向堆上的内存地址，而非直接嵌入值，有助于减少内存拷贝。
特殊键名映射：JSON中的 "first fruit" 成功映射到了Go结构体的 FirstFruit 字段，依靠的是 json:"first fruit" 标签。
数组解析：JSON数组 "three fruit array" 被正确解析为Go的 []string 切片。