Go语言用encoding/json包解析JSON,需定义带json标签的结构体,用json.Unmarshal反序列化、json.Marshal序列化,支持嵌套、数组、动态结构及文件读写,注意错误处理和类型匹配。

Go语言内置的encoding/json包提供了简洁高效的方式解析、读取和操作JSON数据,无需第三方依赖。核心在于理解结构体标签(struct tags)、反序列化(json.Unmarshal)与序列化(json.Marshal)流程,以及如何处理嵌套、动态或不规则JSON。
读取JSON文件并解析为Go结构体
这是最常见场景:将磁盘上的JSON文件内容加载进内存,并映射为类型安全的Go结构体。
- 用
os.ReadFile(Go 1.16+)或ioutil.ReadFile(旧版)读取文件字节流 - 定义与JSON字段一一对应的Go结构体,通过
json:"field_name"标签指定映射关系(支持大小写、省略空值、重命名等) - 调用
json.Unmarshal(data, &v)完成反序列化;注意传入指针,且检查错误
示例:
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Email string `json:"email,omitempty"` // 空字符串时序列化中忽略
Active bool `json:"active"`
}
data, err := os.ReadFile("user.json")
if err != nil {
log.Fatal(err)
}
var u User
if err := json.Unmarshal(data, &u); err != nil {
log.Fatal(err)
}
fmt.Printf("User: %+v\n", u)
处理嵌套JSON和数组
JSON中常见对象嵌套、数组列表,Go中对应结构体字段可声明为嵌套结构体或切片。
立即学习“go语言免费学习笔记(深入)”;
- 嵌套对象:在结构体中嵌入另一个结构体字段,标签照常标注
- JSON数组:字段类型设为
[]T,其中T是元素结构体或基础类型 - 混合数组(如不同对象类型混排)需用
interface{}或json.RawMessage延迟解析
例如:
type Address struct {
City string `json:"city"`
Zip string `json:"zip"`
}
type Profile struct {
Name string `json:"name"`
Addresses []Address `json:"addresses"`
}
动态解析未知结构的JSON
当JSON结构不确定(如API返回格式多变、配置项灵活),可用map[string]interface{}或json.RawMessage。
-
json.Unmarshal支持直接解析到map[string]interface{},但需类型断言访问值(如v["age"].(float64)) -
json.RawMessage可暂存未解析的JSON片段,推迟到需要时再解,避免重复解析或中间转换开销 - 对深层嵌套路径查找,可配合
gjson等轻量库(非标准库,按需引入)
修改并写回JSON文件
解析后修改结构体字段,再序列化保存即可。
- 修改结构体字段值(如
u.Name = "Alice") - 用
json.MarshalIndent生成格式化JSON(便于阅读和调试),或json.Marshal生成紧凑格式 - 使用
os.WriteFile写入文件;注意设置合理权限(如0644)
示例:
u.Name = "Alice"
u.Active = true
output, err := json.MarshalIndent(u, "", " ")
if err != nil {
log.Fatal(err)
}
if err := os.WriteFile("user.json", output, 0644); err != nil {
log.Fatal(err)
}
不复杂但容易忽略:始终检查Unmarshal/Marshal的错误;注意JSON数字默认解析为float64,整数场景建议显式定义为int并确保源数据合规;时间字段推荐用time.Time配合json:"time,string"实现RFC3339字符串解析。










