GolangJSON处理：marshal与unmarshal教程

本文深入解析了 Golang 中 JSON 数据的处理，重点讲解了 `encoding/json` 包中的核心函数 `json.Marshal` 和 `json.Unmarshal` 的使用。`json.Marshal` 用于将 Go 结构体序列化为 JSON 字符串，需要关注字段导出、`json` 标签以及 `omitempty` 选项的应用，以便灵活控制输出格式。`json.Unmarshal` 则负责将 JSON 字符串反序列化为 Go 结构体，务必传入指针类型，并理解其忽略多余字段的特性。文章还介绍了嵌套结构体和使用 `map[string]interface{}` 处理动态 JSON 结构的技巧，帮助开发者应对更复杂的 JSON 数据场景。掌握这些方法，能有效提升 Golang 应用在 Web 开发和 API 接口设计中处理 JSON 数据的能力。

在 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 函数。

基本用法如下：

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。

基本用法如下：

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 场景了。虽然看起来简单，但在字段命名、嵌套结构和类型匹配上稍不注意就会出错，建议多测试边界情况。

以上就是《GolangJSON处理：marshal与unmarshal教程》的详细内容，更多关于的资料请关注golang学习网公众号！