首页 > Golang > Go教程

GolangJSON读写与序列化教程

时间：2026-01-14 12:51:40 262浏览收藏

在IT行业这个发展更新速度很快的行业，只有不停止的学习，才不会被行业所淘汰。如果你是Golang学习者，那么本文《Golang JSON读写与数据序列化教程》就很适合你！本篇内容主要包括##content_title##，希望对大家的知识积累有所帮助，助力实战开发！

Go语言用encoding/json包实现JSON序列化与反序列化，需通过结构体标签（如json:"name"、omitempty）控制字段映射，配合os.ReadFile/WriteFile完成文件读写，注意指针传递、错误检查及类型一致性。

如何使用Golang实现JSON文件读写_序列化和反序列化数据

Go语言内置的encoding/json包提供了简洁高效的JSON序列化（marshal）和反序列化（unmarshal）能力，配合os包可轻松完成JSON文件的读写。核心在于结构体标签（struct tags）与数据类型的正确映射。

定义结构体并设置JSON标签

要让Go正确处理JSON字段名、忽略空值或可选字段，需在结构体字段后添加json:标签：

json:"name"：指定JSON中对应的字段名（支持小写）
json:"name,omitempty"：该字段为空值（零值）时不参与序列化
json:"-" ：完全忽略该字段
json:"name,string"：将数值类型（如int）以字符串形式编解码（常用于API兼容）

示例结构体：

type User struct {
  ID int `json:"id"`
  Name string `json:"name"`
  Email string `json:"email,omitempty"`
  Active bool `json:"active"`
}

将结构体写入JSON文件（序列化）

使用json.Marshal将Go值转为字节切片，再用os.WriteFile保存到磁盘：

先调用json.Marshal获取格式化的JSON字节；可选json.MarshalIndent生成带缩进的可读JSON
用os.WriteFile(filename, data, 0644)写入文件（权限0644表示用户可读写，组和其他用户只读）
务必检查error，如结构体含不可序列化的字段（如函数、channel）会报错

简明写法示例：

user := User{ID: 1, Name: "Alice", Active: true}
data, err := json.MarshalIndent(user, "", " ")
if err != nil {
log.Fatal(err)
}
err = os.WriteFile("user.json", data, 0644)
if err != nil {
log.Fatal(err)
}

从JSON文件读取并解析为结构体（反序列化）

使用os.ReadFile加载文件内容，再用json.Unmarshal解析为结构体指针：

json.Unmarshal第二个参数必须是目标结构体的指针（&v），否则无效果
若JSON字段多于结构体字段，多余字段被忽略；若字段少，对应结构体字段保持零值
类型不匹配（如JSON字符串赋给int字段）会返回json.UnmarshalTypeError

示例：

data, err := os.ReadFile("user.json")
if err != nil {
log.Fatal(err)
}
var user User
err = json.Unmarshal(data, &user)
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", user) // 输出：{ID:1 Name:"Alice" Email:"" Active:true}

处理嵌套、切片与动态JSON

JSON中的对象数组、嵌套对象可直接映射为Go切片或嵌套结构体：

JSON数组 [{"name":"A"},{"name":"B"}] → []User
嵌套对象 {"profile":{"age":25}} → 字段类型为Profile ProfileInfo，其中ProfileInfo是另一结构体
不确定结构时可用map[string]interface{}或json.RawMessage延迟解析

例如解析含用户列表的JSON：

type Response struct {
Users []User `json:"users"`
Total int `json:"total"`
}
// 反序列化后可直接访问 response.Users[0].Name

不复杂但容易忽略细节：标签拼写、指针传递、错误检查和类型一致性是JSON读写稳定的关键。

好了，本文到此结束，带大家了解了《GolangJSON读写与序列化教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！

前往漫画官网入口并下载 ➜