Golang解析JSON数据方法详解

本文深入讲解了Go语言中使用标准库encoding/json包高效解析、读取、修改和写回JSON数据的完整实践，涵盖从定义带json标签的结构体、处理嵌套对象与数组，到动态解析未知结构（如map[string]interface{}和json.RawMessage）、安全序列化与文件I/O等核心场景，并强调了错误处理、类型匹配、整数精度、时间格式等易错细节——无需第三方依赖，即可写出健壮、清晰、生产就绪的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: %+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字符串解析。

本篇关于《Golang解析JSON数据方法详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！