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

本教程深入解析Golang中JSON数据的序列化与反序列化，这是构建高效Web服务的关键技能。文章首先介绍如何利用结构体字段标签（Tag），如`json:"name"`，自定义JSON键名并使用`omitempty`选项控制字段输出，灵活应对API数据格式需求。接着，详细讲解`json.Marshal()`和`json.Unmarshal()`的用法，实现结构体与JSON字符串之间的转换，并探讨如何使用`json.MarshalIndent()`生成美观格式的JSON。此外，文章还涵盖了嵌套结构、数组、切片以及指针等复杂类型的处理，以及如何使用`map[string]interface{}`进行动态JSON解析。掌握这些核心技巧，你就能在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是非常常见的需求，特别是在构建Web服务时。Go语言的标准库encoding/json提供了完整的功能来完成结构体与JSON之间的序列化和反序列化操作。这篇文章就带你掌握几个核心点，让你轻松应对日常开发中的JSON处理。

结构体字段标签（Tag）的使用

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

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字节切片：

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学习网公众号了解相关技术文章。