GolangJSON处理：Marshal与Unmarshal详解

学习Golang要努力，但是不要急！今天的这篇文章《Golang JSON处理详解：Marshal与Unmarshal用法》将会介绍到等等知识点，如果你想深入学习Golang，可以关注我！我会持续更新相关文章的，希望对大家都能有所帮助！

在 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学习网公众号，带你了解更多关于的知识点！