在 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 函数。
基本用法如下：
立即学习“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("%+vn", 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 场景了。虽然看起来简单，但在字段命名、嵌套结构和类型匹配上稍不注意就会出错，建议多测试边界情况。
