在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字符串解析到结构体。

立即学习“go语言免费学习笔记（深入）”；

举个例子：

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)

几点需要注意：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

• 字段名首字母要大写，否则无法被导出（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不算复杂，但有些细节容易忽略，比如字段导出、指针传递、嵌套结构等。掌握这几个基本用法，应付日常开发已经绰绰有余了。