Golang解析JSON数据:读取与操作教程
作者:归人云淡风轻
时间:2026-02-16
浏览:1
Go语言用encoding/json包解析JSON,需定义带json标签的结构体,用json.Unmarshal反序列化、json.Marshal序列化,支持嵌套、数组、动态结构及文件读写,注意错误处理和类型匹配。
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中对应结构体字段可声明为嵌套结构体或切片。
- 嵌套对象:在结构体中嵌入另一个结构体字段,标签照常标注
- 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字符串解析。
作者最新文章
荣耀MagicOS 11发布计划与Agent Harness架构解析
2026-09-08 19:23
AI重构企业业务架构:超聚变“智企”范式核心解析
2026-09-08 18:39
PDF合并工具怎么选?在线合并5步实操指南
2026-09-04 17:05
PDF图片压缩工具推荐与批量处理实操指南
2026-09-03 12:14
照片如何转成PDF格式?三种图片转PDF操作方法
2026-09-03 11:04
上一篇:
美团退款流程及申请方法详解
热门文章
更多
精品专题
更多
Mac软件
更多
WINDOWS
更多


































