当前位置：首页 > 文章列表 > Golang > Go教程 > GolangJSON序列化反序列化教程

GolangJSON序列化反序列化教程

2026-02-19 08:09:34 0浏览收藏

本文深入讲解了Go语言中encoding/json包的核心用法，涵盖结构体、map和slice的JSON序列化与反序列化实战技巧：通过json tag精准控制字段名与行为（如omitempty忽略零值）、强调指针传参与导出字段限制、演示string tag对数字字符串化、RFC3339时间格式推荐，以及处理多余字段、数值类型解析等关键细节，是构建API服务、配置解析和数据交互不可或缺的实用指南。

如何用Golang使用encoding/json.Marshal和Unmarshal_Golang JSON序列化反序列化实践

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

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

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

示例代码：

package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name     string json:"name"
Age      int    json:"age"
Email    string json:"email,omitempty"
IsActive bool   json:"is_active"
}
func main() {
user := User{
Name:     "Alice",
Age:      30,
Email:    "alice@example.com",
IsActive: true,
}
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}
}

说明：
- 结构体字段上的 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}`
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}
}

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

3. 处理 map 和 slice 的 JSON 转换

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

示例：map 转 JSON

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]]