如何使用Golang实现JSON数据解析_读取和操作JSON文件内容

14次阅读

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

如何使用Golang实现JSON数据解析_读取和操作JSON文件内容

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: %+vn", 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字符串解析

text=ZqhQzanResources