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

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保存到磁盘:
立即学习“go语言免费学习笔记(深入)”;
- 先调用
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读写稳定的关键。










