GolangJSON解析：encoding/json入门教程

本文针对Go语言开发者，详细介绍了如何使用`encoding/json`包进行JSON数据的解析与生成。作为Go语言处理JSON的首选方案，`encoding/json`支持结构化和非结构化的数据处理。文章重点讲解了结构体与JSON之间的互相转换，包括如何通过`json`标签控制字段名，以及`json.Marshal`和`json.Unmarshal`的使用方法。此外，还介绍了使用`map[string]interface{}`解析未知结构JSON的技巧，以及处理嵌套JSON结构的方法。文章还分享了忽略字段、空值处理、时间类型格式化等实用技巧，并给出了性能优化建议，旨在帮助开发者快速掌握Golang中JSON处理的核心要点，提升开发效率。

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

基本上就这些，Golang处理JSON不算复杂，但有些细节容易忽略，比如字段导出、指针传递、嵌套结构等。掌握这几个基本用法，应付日常开发已经绰绰有余了。

理论要掌握，实操不能落！以上关于《GolangJSON解析：encoding/json入门教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！