登录
首页 >  Golang >  Go教程

GolangJSON处理:Marshal与Unmarshal详解

时间:2025-07-16 10:27:51 384浏览 收藏

偷偷努力,悄无声息地变强,然后惊艳所有人!哈哈,小伙伴们又来学习啦~今天我将给大家介绍《Golang JSON处理详解:Marshal与Unmarshal用法》,这篇文章主要会讲到等等知识点,不知道大家对其都有多少了解,下面我们就一起来看一吧!当然,非常希望大家能多多评论,给出合理的建议,我们一起学习,一起进步!

在 Golang 中处理 JSON 数据主要通过 encoding/json 包中的 json.Marshal 和 json.Unmarshal 实现。1. 使用 json.Marshal 可将结构体转为 JSON 字符串,需注意字段导出、标签控制和 omitempty 的使用;2. 使用 json.Unmarshal 可将 JSON 字符串解析为结构体,需传入指针且忽略多余字段;3. 支持嵌套结构及通过 map 处理不确定结构的 JSON 数据,提升灵活性。掌握这些方法可应对大多数 JSON 场景。

Golang如何实现JSON处理 解析marshal与unmarshal的用法

在 Golang 中处理 JSON 数据非常常见,尤其是在开发 Web 应用或 API 接口时。Go 标准库中的 encoding/json 包提供了两个核心函数:json.Marshaljson.Unmarshal,分别用于将结构体转换为 JSON 数据(序列化)以及将 JSON 数据还原为结构体(反序列化)。下面我们就来看看它们的典型用法和注意事项。

Golang如何实现JSON处理 解析marshal与unmarshal的用法

1. 使用 json.Marshal 将结构体转为 JSON 字符串

当你需要把 Go 的结构体、map 或者切片等数据结构转成 JSON 格式字符串时,就可以使用 json.Marshal 函数。

Golang如何实现JSON处理 解析marshal与unmarshal的用法

基本用法如下:

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}

注意点:

Golang如何实现JSON处理 解析marshal与unmarshal的用法
  • 结构体字段必须是导出的(首字母大写),否则不会被序列化。
  • 可以通过 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.Marshaljson.Unmarshal 的使用方式,配合结构体标签和 map,就能处理大多数 JSON 场景了。虽然看起来简单,但在字段命名、嵌套结构和类型匹配上稍不注意就会出错,建议多测试边界情况。

今天关于《GolangJSON处理:Marshal与Unmarshal详解》的内容介绍就到此结束,如果有什么疑问或者建议,可以在golang学习网公众号下多多回复交流;文中若有不正之处,也希望回复留言以告知!

相关阅读
更多>
最新阅读
更多>
课程推荐
更多>