Go语言解析JSON的三种常用方式与实战代码

陆景行

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

原创

Go语言处理JSON数据是后端开发中的高频操作。本文总结了解析JSON的三种主流方式：使用标准库将JSON反序列化为Map对象、映射为强类型结构体（Struct），以及利用第三方库`gjson`进行高效字段提取。针对不同场景提供了代码示例与最佳实践建议。

背景

在Web开发和API交互中，JSON是最常用的数据交换格式。对于刚接触Go语言的新手或需要优化现有代码的开发者来说，理解如何高效、准确地解析JSON字符串至关重要。本文将介绍三种不同侧重点的解析方案，并解释其背后的原理。

示例数据

为了方便演示，我们假设需要解析如下结构的JSON数据：

{
   "userName":"admin",
   "nick_name":"管理员",
   "info":{
      "age":18
   },
   "extra":[
      {
         "address":"上海市"
      },
      {
         "address":"北京市"
      }
   ]
}

三种解析方式

下面通过一段完整的Go代码，展示如何分别使用这三种方式处理上述JSON字符串。

第1步：定义数据结构与准备数据

首先，我们需要定义与JSON对应的Go结构体，并准备好待解析的JSON字符串。

package main

import (
    "encoding/json"
    "log"
    "github.com/tidwall/gjson"
)

// 嵌套对象结构体
type Info struct {
    Age int `json:"age"`
}

// 嵌套数组元素结构体
type Extra struct {
    Address string `json:"address"`
}

// 主结构体定义
// 注意：json tag用于指定JSON字段名与Go结构体字段的映射关系
type UserRequest struct {
    Name     string  `json:"userName"`
    NickName string  `json:"nick_name"`
    info     Info    `json:"info"` // 小写私有字段，json解组时会忽略
    Extra    []Extra `json:"extra"`
}

func main() {
    jsonStr := `
    {
        "userName":"admin",
        "nick_name":"管理员",
        "info":{
           "age":18
        },
        "extra":[
           {
              "address":"上海市"
           },
           {
              "address":"北京市"
           }
        ]
     }`

    // ... 后续解析逻辑见下文 ... 
}

第2步：实现三种解析逻辑

在main函数中，我们可以依次执行以下三种操作：

1. 反序列化为 Map<String, interface{}>

这种方式不需要预先定义复杂的结构体，适合JSON结构动态变化或不确定的场景。它将JSON顶层转换为Go的Map，内部嵌套的JSON会自动转换为Map或Slice。

anyMap := make(map[string]interface{}, 0)
if err := json.Unmarshal([]byte(jsonStr), &anyMap); err != nil {
    panic(err)
}
log.Println("Unmarshal to map result:", anyMap)

2. 反序列化为结构体 (Struct)

这是最常用且类型安全的方式。通过json.Unmarshal将二进制数据直接填充到定义好的结构体实例中，方便后续的类型断言和方法调用。

req := UserRequest{}
if err := json.Unmarshal([]byte(jsonStr), &req); err != nil {
    panic(err)
}
log.Println("Unmarshal to struct:", req)

3. 使用 gjson 直接提取字段

当JSON非常庞大，或者你只需要其中的几个特定字段时，逐个解析所有数据会浪费性能。此时可以使用第三方库gjson，通过JSON Pointer语法直接获取值。

// 获取简单字段
userName := gjson.Get(jsonStr, "userName")
nickName := gjson.Get(jsonStr, "nick_name")
age := gjson.Get(jsonStr, "info.age").Int()

// 获取数组元素
address1 := gjson.Get(jsonStr, "extra[1].address").String()
log.Println("get raw value by key:", userName, nickName, age, address1)

运行结果大致如下：

Map输出：map[extra:[...] info:map[age:18] ...]
Struct输出：{admin 管理员 {0} [{上海市} {北京市}]}（注：因Info字段未完全匹配Tag导致Age为默认值0，此处仅为演示结构体填充逻辑）
Gjson输出：admin 管理员 18 北京市

原理解析与注意事项

1. 反序列化为 Map 的优缺点

优点：无需定义结构体，灵活性强，适合处理动态JSON。

缺点：取值时需要手动判断key是否存在并进行类型转换（Type Assertion），代码冗余且易出错。例如取age字段需要这样写：

ageVal, ok := anyMap["age"]
if ok {
    age := ageVal.(int) // 必须断言具体类型
    log.Println(age)
}

应用场景：在Gin等Web框架中，经常使用gin.H{"key": "value"}来返回JSON响应，其底层即为map[string]interface{}，因为这样可以快速构建包含任意字段的HTTP响应体。

2. 反序列化为 Struct 的最佳实践

这是Go中处理JSON的标准方式，具备类型安全和IDE智能提示优势。但在编写结构体标签（Tag）时需注意以下三点：

Tag映射：如果Go字段名与JSON Key不一致，必须通过json:"key_name"指定对应关系。若JSON中无对应Key，该字段将保持零值。
可见性：只有首字母大写的导出字段（Exported fields）才能被encoding/json包访问。小写字段（如info Info）将被自动忽略，即使JSON中包含该字段。
嵌套支持：标准库通过反射机制自动处理深层嵌套的对象和数组，无需额外配置。