首页 > Golang > Go教程

GolangJSON序列化反序列化教程

时间：2025-10-07 17:14:28 291浏览收藏

**Golang JSON序列化与反序列化教程：掌握encoding/json高效处理JSON数据** 本文详细介绍了如何在Go语言中使用 `encoding/json` 标准库进行JSON数据的序列化与反序列化操作。通过示例代码，深入讲解了如何利用结构体tag灵活控制字段映射，例如使用 `omitempty` 忽略空值，`-` 忽略私有字段。针对动态JSON数据，提供了使用 `map[string]interface{}` 进行处理的方案，并强调了类型断言的重要性。同时，文章还总结了常见技巧与注意事项，包括时间类型处理、浮点数精度问题等，助你轻松应对各种JSON处理场景，提升Go语言开发效率。掌握 `Marshal` 和 `Unmarshal` 的使用，结合结构体标签，让你高效处理大多数JSON场景。

使用encoding/json实现Go中JSON序列化与反序列化，通过结构体tag控制字段映射，omitempty忽略空值，-忽略私有字段，map[string]interface{}处理动态JSON，注意类型断言与浮点精度问题。

如何使用Golang处理JSON序列化与反序列化

在Go语言中处理JSON数据非常常见，主要通过标准库 encoding/json 来实现序列化（结构体转JSON）和反序列化（JSON转结构体）。下面介绍基本用法、常用技巧以及注意事项。

定义结构体并进行JSON序列化

使用 json.Marshal 可将Go结构体转换为JSON字符串。结构体字段需大写（导出），并通过 json tag 控制输出的键名。

package main

import (
    "encoding/json"
    "fmt"
)

type User struct {
    Name     string `json:"name"`
    Age      int    `json:"age"`
    Email    string `json:"email,omitempty"` // 当Email为空时不输出
    Password string `json:"-"`               // 不参与序列化
}

func main() {
    user := User{
        Name:     "Alice",
        Age:      30,
        Email:    "alice@example.com",
        Password: "secret",
    }

    data, err := json.Marshal(user)
    if err != nil {
        panic(err)
    }

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

从JSON反序列化到结构体

使用 json.Unmarshal 将JSON字节流解析到结构体变量中。确保结构体字段能正确映射JSON中的键。

func main() {
    jsonData := `{"name":"Bob","age":25,"email":"bob@example.com"}`

    var user User
    err := json.Unmarshal([]byte(jsonData), &user)
    if err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", user)
    // 输出：{Name:Bob Age:25 Email:bob@example.com Password:}
}

处理动态或未知结构的JSON

当不清楚JSON结构时，可使用 map[string]interface{} 或 interface{} 进行解析。

func main() {
    jsonData := `{"name":"Charlie","hobbies":["reading","coding"]}`

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

    fmt.Printf("Name: %s\n", data["name"])
    fmt.Printf("Hobbies: %v\n", data["hobbies"])
}

遍历嵌套数据时注意类型断言：

if hobbies, ok := data["hobbies"].([]interface{}); ok {
    for _, h := range hobbies {
        fmt.Println(h)
    }
}

常见技巧与注意事项

字段tag中使用 omitempty 可在值为空（零值）时跳过该字段输出
嵌套结构体同样支持json tag控制序列化行为
时间类型通常用 time.Time，配合 "2006-01-02T15:04:05Z" 格式自动解析
注意浮点数精度问题，JSON数字默认解析为 float64
反序列化时，JSON中的字段若在结构体中不存在会被忽略

基本上就这些。掌握 Marshal 和 Unmarshal 的使用，结合结构体标签，就能高效处理大多数JSON场景。

终于介绍完啦！小伙伴们，这篇关于《GolangJSON序列化反序列化教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！