GolangJSON序列化反序列化教程

**Golang JSON序列化反序列化实践：提升数据处理效率** 本文深入探讨Go语言中`encoding/json`包在JSON序列化与反序列化方面的应用。作为API交互、配置管理和数据存储的关键技术，掌握`json.Marshal`和`json.Unmarshal`至关重要。文章通过实例讲解如何将结构体转换为JSON字符串，并利用`json tag`控制字段名称和忽略零值字段。同时，详细阐述了如何将JSON数据解析为Go结构体，以及处理map和slice等复杂数据结构的转换。此外，还总结了Golang JSON处理的常见注意事项，如导出字段、string tag、时间格式化以及数值类型等，助你高效应对Web服务和微服务通信等多种场景的数据处理需求。

Go语言中encoding/json包用于JSON序列化和反序列化。1. json.Marshal将结构体转为JSON，通过json tag控制字段名，omitempty可忽略零值字段；2. json.Unmarshal将JSON解析到结构体，需传指针，缺失字段设为零值；3. 支持map和slice的转换，如map[string]interface{}转JSON及JSON数组转[]map[string]string；4. 注意事项：仅导出字段有效，可用string tag使数字以字符串编码，时间建议用RFC3339格式，多余JSON字段默认被忽略，数值解析为float64或int64。

在Go语言中，encoding/json 包提供了对JSON数据的序列化（Marshal）和反序列化（Unmarshal）支持。这是处理API请求、配置文件、数据存储等场景中最常用的功能之一。下面通过实际例子说明如何正确使用 json.Marshal 和 json.Unmarshal。

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

json.Marshal 函数可以将 Go 中的数据结构（如结构体、map、slice等）转换为 JSON 格式的字节流。

package main
<p>import (
"encoding/json"
"fmt"
)</p><p>type User struct {
Name     string <code>json:"name"</code>
Age      int    <code>json:"age"</code>
Email    string <code>json:"email,omitempty"</code>
IsActive bool   <code>json:"is_active"</code>
}</p><p>func main() {
user := User{
Name:     "Alice",
Age:      30,
Email:    "alice@example.com",
IsActive: true,
}</p><pre class="brush:php;toolbar:false"><code>data, err := json.Marshal(user)
if err != nil {
    fmt.Printf("序列化失败: %v\n", err)
    return
}

fmt.Println(string(data)) // 输出: {"name":"Alice","age":30,"email":"alice@example.com","is_active":true}</code>

}

说明：
- 结构体字段上的 json tag 控制字段在 JSON 中的名称。
- omitempty 表示如果字段为空（如零值），则不会出现在输出 JSON 中。
- 如果 Email 字段为空字符串，它将不会出现在最终 JSON 中。

2. 使用 json.Unmarshal 将 JSON 字符串解析为结构体

json.Unmarshal 可以将 JSON 数据解析回 Go 的数据结构。

func main() {
    jsonData := `{"name":"Bob","age":25,"is_active":false}`
<pre class="brush:php;toolbar:false"><code>var user User
err := json.Unmarshal([]byte(jsonData), &user)
if err != nil {
    fmt.Printf("反序列化失败: %v\n", err)
    return
}

fmt.Printf("%+v\n", user) // 输出: {Name:Bob Age:25 Email: IsActive:false}</code>

}

注意：
- 第二个参数必须是指向目标变量的指针，否则无法修改原始值。
- JSON 中缺失的字段会被设置为对应类型的零值（如 string 为 ""，int 为 0，bool 为 false）。

3. 处理 map 和 slice 的 JSON 转换

除了结构体，也可以直接对 map 或 slice 进行序列化与反序列化。

data, _ := json.Marshal(map[string]interface{}{
    "id":   1,
    "name": "Test",
    "tags": []string{"go", "json"},
})
fmt.Println(string(data)) // {"id":1,"name":"Test","tags":["go","json"]}

示例：JSON 数组转 slice

jsonStr := `[{"name":"A"},{"name":"B"}]`
var users []map[string]string
json.Unmarshal([]byte(jsonStr), &users)
fmt.Println(users) // [map[name:A] map[name:B]]

4. 常见注意事项与技巧

• 只有导出字段（首字母大写）才会被 json 包处理。
• 使用 string tag 可让数字以字符串形式编码，例如：Age int `json:"age,string"`。
• 时间类型通常配合 time.Time 和自定义格式使用，建议统一使用 RFC3339 格式。
• 反序列化时若 JSON 字段多于结构体字段，多余字段默认被忽略；若想捕获，可用 map[string]interface{}。
• 浮点数解析默认使用 float64，整数为 int64，注意数值范围。

基本上就这些。掌握 json.Marshal 和 json.Unmarshal 是Golang开发中的基础技能，结合结构体tag能灵活控制输出格式，适用于Web服务、微服务通信等多种场景。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。