Golang json数据序列化与反序列化实践-Golang-PHP中文网

Golang json数据序列化与反序列化实践

P粉602998670

发布： 2025-10-05 21:16:02

原创

603人浏览过

Go通过encoding/json包实现JSON序列化与反序列化，使用结构体标签如json:"name"控制字段映射，omitempty在值为空时忽略字段，json:"-"排除字段；通过json.Marshal将结构体转为JSON字符串，json.Unmarshal将JSON解析到结构体或map；支持嵌套结构与切片，字段需以大写字母开头方可导出。

golang json数据序列化与反序列化实践

在Go语言开发中，处理JSON数据是常见需求，特别是在构建Web服务、API接口或配置解析时。Golang通过encoding/json包提供了强大且高效的JSON序列化与反序列化支持。本文将结合实际用法，介绍如何正确使用该功能。

结构体与JSON字段映射

Go中通常使用结构体（struct）来表示JSON数据结构。通过结构体标签（tag），可以控制字段在JSON中的名称和行为。

例如，定义一个用户信息结构体：

type User struct {
    ID    int    `json:"id"`
    Name  string `json:"name"`
    Email string `json:"email,omitempty"`
    Age   int    `json:"-"`
}

登录后复制

说明：

立即学习“go语言免费学习笔记（深入）”；

json:"id"：指定该字段在JSON中显示为"id"
omitempty：当Email为空字符串时，序列化结果中将不包含该字段
json:"-"：表示该字段不会被序列化或反序列化

序列化：Go对象转JSON字符串

使用json.Marshal()将Go结构体转换为JSON字节流。

user := User{ID: 1, Name: "Alice", Email: "alice@example.com", Age: 25}
data, err := json.Marshal(user)
if err != nil {
    log.Fatal(err)
}
fmt.Println(string(data))
// 输出：{"id":1,"name":"Alice","email":"alice@example.com"}

登录后复制

注意Age字段因使用json:"-"未出现在输出中，Email正常输出。

若想让JSON更易读，可使用json.MarshalIndent()生成格式化JSON。

序列猴子开放平台

具有长序列、多模态、单模型、大数据等特点的超大规模语言模型

查看详情

反序列化：JSON字符串转Go对象

使用json.Unmarshal()将JSON数据解析到结构体或map中。

jsonData := `{"id":2,"name":"Bob","email":"bob@example.com"}`
var user User
err := json.Unmarshal([]byte(jsonData), &user)
if err != nil {
    log.Fatal(err)
}
fmt.Printf("%+v\n", user)
// 输出：{ID:2 Name:Bob Email:bob@example.com Age:0}
</font>

登录后复制

如果JSON中包含结构体没有的字段，默认会忽略；反之，结构体中有但JSON中缺失的字段会被赋予零值。

对于动态或未知结构的JSON，可以使用map[string]interface{}接收：

var data map[string]interface{}
json.Unmarshal([]byte(jsonData), &data)
fmt.Println(data["name"]) // 输出：Bob

登录后复制

处理嵌套结构与切片

JSON常包含数组或嵌套对象，Go可通过切片和嵌套结构体处理。

type Order struct {
    OrderID string `json:"order_id"`
    Items   []Item `json:"items"`
}

type Item struct {
    Product string `json:"product"`
    Count   int    `json:"count"`
}

登录后复制

示例JSON：

{
  "order_id": "ORD001",
  "items": [
    {"product": "Laptop", "count": 1},
    {"product": "Mouse", "count": 2}
  ]
}

登录后复制

反序列化后可直接访问order.Items[0].Product等字段。

基本上就这些。掌握结构体标签、Marshal/Unmarshal的使用以及对nil、omitempty的处理，就能应对大多数JSON场景。不复杂但容易忽略细节，比如字段必须可导出（大写开头）才会参与序列化。按照规范写，基本不会出问题。

以上就是Golang json数据序列化与反序列化实践的详细内容，更多请关注php中文网其它相关文章！