当前位置：首页 > 文章列表 > Golang > Go教程 > GolangJSON解析：encoding/json入门指南

GolangJSON解析：encoding/json入门指南

2025-08-03 17:02:31 0浏览收藏

本文是关于Golang中使用`encoding/json`包进行JSON数据解析的基础教程，旨在帮助开发者快速上手并掌握关键用法。在Go语言中，`encoding/json`包提供了结构化和非结构化的JSON处理能力。文章详细讲解了结构体与JSON的互相转换，包括如何使用json标签控制字段名、序列化与反序列化的方法，以及处理未知结构JSON时如何使用`map[string]interface{}`进行灵活解析。此外，还介绍了嵌套结构的解析方法、忽略字段、空值处理、时间类型自定义格式等实用技巧，并提出了性能优化建议。掌握这些要点，能有效应对日常开发中的JSON处理需求。

在Go语言中处理JSON数据最常用的方式是使用encoding/json包。该包支持结构化和非结构化的解析与生成，主要用法包括：1. 结构体与JSON的互相转换，需定义结构体并使用json标签控制字段名，序列化用json.Marshal，反序列化用json.Unmarshal且需传入指针；2. 解析未知结构的JSON时可使用map[string]interface{}进行灵活解析，但需手动做类型断言；3. 嵌套结构可通过定义对应的嵌套结构体来处理，只要结构匹配即可正确映射；4. 其他技巧如忽略字段用json:"-"，空值处理加omitempty，时间类型可自定义格式，性能优化则建议提前定义好结构体和变量以减少内存分配。掌握这些要点能够满足日常开发中的JSON处理需求。

怎样用Golang处理JSON数据解析encoding/json的基本用法

在Go语言中处理JSON数据，最常用的方式是使用标准库里的 encoding/json 包。这个包提供了结构化和非结构化的JSON解析与生成能力，适合大多数实际场景。

下面我们就来看看几个关键用法，帮助你快速上手。

结构体与JSON的互相转换

这是最常见的需求：把一个结构体转成JSON字符串，或者反过来，从JSON字符串解析到结构体。

举个例子：

type User struct {
    Name  string `json:"name"`
    Age   int    `json:"age"`
    Email string `json:"email,omitempty"` // omitempty表示如果为空则忽略该字段
}

你可以这样把结构体转为JSON：

user := User{Name: "Alice", Age: 25}
data, _ := json.Marshal(user)
fmt.Println(string(data)) // 输出：{"name":"Alice","age":25}

反过来也一样：

jsonStr := `{"name":"Bob","age":30}`
var user2 User
json.Unmarshal([]byte(jsonStr), &user2)

几点需要注意：

字段名首字母要大写，否则无法被导出（exported）
使用标签（tag）控制JSON字段名
接收数据时一定要传指针（&user）

解析未知结构的JSON（map方式）

有时候你不知道JSON的具体结构，比如接收到第三方API返回的数据，这时候可以用 map[string]interface{} 来解析。

例如：

jsonStr := `{"name":"Tom","hobbies":["reading","coding"]}`
var data map[string]interface{}
json.Unmarshal([]byte(jsonStr), &data)

fmt.Println(data["name"])         // 输出 Tom
fmt.Println(data["hobbies"])      // 输出 [reading coding]

这种方式灵活但需要手动做类型断言：

hobbies := data["hobbies"].([]interface{})
for _, h := range hobbies {
    fmt.Println(h.(string))
}

适用于结构不固定或嵌套较深的场景。

嵌套结构怎么处理？

遇到嵌套结构，比如结构体里嵌套另一个结构体，也不用担心，只要定义好对应的结构即可。

比如：

type Address struct {
    City  string `json:"city"`
    Zip   string `json:"zip"`
}

type User struct {
    Name    string  `json:"name"`
    Contact Address `json:"contact"`
}

对应的JSON：

{
  "name": "John",
  "contact": {
    "city": "Shanghai",
    "zip": "200000"
  }
}

解析过程是一样的，只要结构对得上，就能正确映射进去。

小技巧和常见问题

字段忽略：加 json:"-" 可以让字段不参与序列化
空值处理：加上 omitempty 可避免输出空字段，如 "email,omitempty"
字段必须存在但允许为空：omitempty 会跳过零值，但如果想保留字段，即使为空也要显式写出，就不加这个选项
时间类型处理：time.Time 默认格式是RFC3339，如需自定义，可以包装类型并实现 MarshalJSON 和 UnmarshalJSON
性能优化：如果频繁处理大量JSON，可以考虑提前定义好结构体和变量，避免重复分配内存