在 golang 中处理 json 数据主要通过 encoding/json 包中的 json.marshal 和 json.unmarshal 实现。1. 使用 json.marshal 可将结构体转为 json 字符串，需注意字段导出、标签控制和 omitempty 的使用；2. 使用 json.unmarshal 可将 json 字符串解析为结构体，需传入指针且忽略多余字段；3. 支持嵌套结构及通过 map 处理不确定结构的 json 数据，提升灵活性。掌握这些方法可应对大多数 json 场景。
在 Golang 中处理 JSON 数据非常常见，尤其是在开发 Web 应用或 API 接口时。Go 标准库中的 encoding/json 包提供了两个核心函数：json.Marshal 和 json.Unmarshal，分别用于将结构体转换为 JSON 数据（序列化）以及将 JSON 数据还原为结构体（反序列化）。下面我们就来看看它们的典型用法和注意事项。
1. 使用 json.Marshal 将结构体转为 JSON 字符串
当你需要把 Go 的结构体、map 或者切片等数据结构转成 JSON 格式字符串时，就可以使用 json.Marshal 函数。
基本用法如下：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
type User struct {
Name string `json:"name"`
Age int `json:"age"`
Email string `json:"email,omitempty"` // omitempty 表示如果为空则不输出该字段
}
user := User{
Name: "Alice",
Age: 25,
}
data, _ := json.Marshal(user)
fmt.Println(string(data))
// 输出: {"name":"Alice","age":25}注意点：
- 结构体字段必须是导出的（首字母大写），否则不会被序列化。
- 可以通过
json:"name"这样的标签来控制字段名。 - 使用
omitempty可以避免空值字段出现在结果中。
2. 使用 json.Unmarshal 将 JSON 字符串转为结构体
当你从网络接收到一段 JSON 数据，想要把它解析为 Go 的结构体变量时，就用 json.Unmarshal。
基本用法如下：
立即学习“go语言免费学习笔记（深入）”；
jsonStr := `{"name":"Bob","age":30,"email":"bob@example.com"}`
var user User
err := json.Unmarshal([]byte(jsonStr), &user)
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", user)
// 输出: {Name:Bob Age:30 Email:bob@example.com}注意点：
- 解析目标必须是指针类型，否则不会修改原始变量。
- 如果 JSON 中有字段在结构体中不存在，会被忽略。
- 如果结构体字段名与 JSON 键名不同，可以使用标签匹配。
3. 嵌套结构与 map 处理更灵活
除了简单的结构体，你也可以处理嵌套结构或者直接使用 map[string]interface{} 来应对不确定结构的 JSON 数据。
例如嵌套结构：
type Address struct {
City string `json:"city"`
Zip string `json:"zip"`
}
type User struct {
Name string `json:"name"`
Address Address `json:"address"`
}
jsonStr := `{"name":"Charlie","address":{"city":"Shanghai","zip":"200000"}}`
var user User
json.Unmarshal([]byte(jsonStr), &user)用 map 处理动态结构：
var data map[string]interface{}
json.Unmarshal([]byte(jsonStr), &data)
fmt.Println(data["name"]) // Charlie
fmt.Println(data["address"]) // map[city:Shanghai zip:200000]这种方式适合不知道具体结构，或者结构可能变化的情况。
基本上就这些了。掌握好 json.Marshal 和 json.Unmarshal 的使用方式，配合结构体标签和 map，就能处理大多数 JSON 场景了。虽然看起来简单，但在字段命名、嵌套结构和类型匹配上稍不注意就会出错，建议多测试边界情况。
