登录
首页 >  Golang >  Go教程

GolangJSON教程:序列化与反序列化详解

时间:2025-06-29 08:05:51 431浏览 收藏

今日不肯埋头,明日何以抬头!每日一句努力自己的话哈哈~哈喽,今天我将给大家带来一篇《Golang JSON处理教程:序列化与反序列化详解》,主要内容是讲解等等,感兴趣的朋友可以收藏或者有更好的建议在评论提出,我都会认真看的!大家一起进步,一起学习!

在Golang中处理JSON的核心在于掌握结构体标签、序列化与反序列化方法及嵌套结构处理。1. 使用结构体字段标签如json:"name"可自定义JSON键名,支持omitempty和-等选项控制输出行为;2. 通过json.Marshal()将结构体转为JSON字符串,结合omitempty可省略空字段,使用json.MarshalIndent()可输出美观格式;3. 利用json.Unmarshal()将JSON解析为结构体,需传入指针且字段名匹配即可,支持动态解析到map[string]interface{};4. 嵌套结构如包含地址信息的用户结构同样支持序列化与反序列化,数组、切片、指针等复杂类型也能被标准库妥善处理。这些技巧构成了Go语言中高效处理JSON数据的基础。

Golang中的JSON如何处理 Golang JSON序列化与反序列化教程

在Golang中处理JSON是非常常见的需求,特别是在构建Web服务时。Go语言的标准库encoding/json提供了完整的功能来完成结构体与JSON之间的序列化和反序列化操作。这篇文章就带你掌握几个核心点,让你轻松应对日常开发中的JSON处理。

Golang中的JSON如何处理 Golang JSON序列化与反序列化教程

结构体字段标签(Tag)的使用

Go语言通过结构体的字段标签(Tag)来控制JSON序列化后的键名。默认情况下,结构体会以字段名为小写形式作为JSON的键,但我们可以用json:"xxx"来自定义:

Golang中的JSON如何处理 Golang JSON序列化与反序列化教程
type User struct {
    Name  string `json:"name"`
    Age   int    `json:"age"`
    Email string `json:"email,omitempty"` // omitempty 表示如果为空则不输出该字段
}
  • 标签语法: 标签值由空格分隔多个选项,第一个是目标格式名称(这里是json),后面可跟选项如omitempty
  • 常用选项:
    • omitempty:当字段为空(零值)时不包含进JSON输出
    • -:忽略该字段,不参与序列化/反序列化

这样你就可以灵活地控制输出格式,比如返回API数据时去掉敏感字段或空字段。


序列化:将结构体转为JSON字符串

使用json.Marshal()可以将结构体转换成JSON字节切片:

Golang中的JSON如何处理 Golang JSON序列化与反序列化教程
user := User{
    Name:  "Alice",
    Age:   25,
    Email: "",
}

data, _ := json.Marshal(user)
fmt.Println(string(data)) // {"name":"Alice","age":25}

注意:

  • 如果结构体中有字段被标记了omitempty且其值为零值(如空字符串、0、nil等),则不会出现在最终结果中。
  • 错误处理很重要,虽然上面用了_忽略错误,但在生产代码中应检查是否出错。

如果你希望输出带缩进的美观格式(调试时很有用),可以用json.MarshalIndent()


反序列化:将JSON解析为结构体

将JSON字符串还原为Go结构体也很简单,只需要调用json.Unmarshal()函数:

jsonData := `{"name":"Bob","age":30}`
var user User
json.Unmarshal([]byte(jsonData), &user)

几点需要注意:

  • 第二个参数必须是指针,否则不会修改原始变量
  • JSON字段名要与结构体字段标签匹配(大小写不敏感)
  • 多余的JSON字段不会报错,只是被忽略;缺少字段也不会影响解析

如果不知道具体结构,也可以使用map[string]interface{}interface{}进行泛化解析:

var data map[string]interface{}
json.Unmarshal(jsonBytes, &data)

适用于动态内容或配置文件读取等场景。


嵌套结构与复杂类型处理

结构体嵌套也是常见情况,比如一个用户可能有地址信息:

type Address struct {
    City  string `json:"city"`
    Zip   string `json:"zip"`
}

type User struct {
    Name    string  `json:"name"`
    Address Address `json:"address"`
}

序列化和反序列化对嵌套结构也完全支持,只要结构一致就能正常工作。

另外,像数组、切片、指针等类型也能很好地处理:

type Result struct {
    Tags []string `json:"tags"`
}

基本上就这些。Golang处理JSON的方式简洁又强大,标准库已经能满足大部分需求。只要掌握了结构体标签、基本的序列化和反序列化方法,以及如何处理嵌套结构,就可以在实际项目中游刃有余了。

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

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