登录
首页 >  Golang >  Go教程

GolangJSON序列化反序列化教程

时间:2025-10-16 13:30:34 449浏览 收藏

欢迎各位小伙伴来到golang学习网,相聚于此都是缘哈哈哈!今天我给大家带来《Golang JSON序列化与反序列化教程》,这篇文章主要讲到等等知识,如果你对Golang相关的知识非常感兴趣或者正在自学,都可以关注我,我会持续更新相关文章!当然,有什么建议也欢迎在评论留言提出!一起学习!

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:"-"`
}

说明:

  • 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}

如果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场景。不复杂但容易忽略细节,比如字段必须可导出(大写开头)才会参与序列化。按照规范写,基本不会出问题。

本篇关于《GolangJSON序列化反序列化教程》的介绍就到此结束啦,但是学无止境,想要了解学习更多关于Golang的相关知识,请关注golang学习网公众号!

相关阅读
更多>
最新阅读
更多>
课程推荐
更多>