Golang处理JSON数组与对象方法详解

本文深入解析了Go语言中处理JSON数据的核心技巧，涵盖固定结构与动态结构的两种典型场景：针对结构明确的JSON对象，推荐使用带json tag的结构体配合Unmarshal/Marshal实现高效、类型安全的序列化与反序列化；面对字段不确定或嵌套复杂的JSON，则灵活采用map[string]interface{}和类型断言；对于JSON数组，既支持直接映射为结构体切片以获得强类型保障，也可用[]map[string]interface{}应对变化。文章还强调了omitempty、指针传递、类型断言等易被忽视却至关重要的实践细节，帮助开发者避开常见陷阱，写出更健壮、可维护的JSON处理代码。

在Golang中处理JSON数组与对象，主要依赖标准库 encoding/json。核心操作包括序列化（结构体转JSON）和反序列化（JSON转结构体或map）。下面介绍常见使用方式和技巧。

定义结构体处理JSON对象

如果JSON数据结构固定，推荐使用结构体。通过字段标签（tag）映射JSON键名。

type User struct {
    Name  string `json:"name"`
    Age   int    `json:"age"`
    Email string `json:"email,omitempty"` // omitempty 表示空值时忽略
}

使用 json.Unmarshal 解析JSON字符串到结构体：

jsonData := `{"name": "Alice", "age": 25}`
var user User
err := json.Unmarshal([]byte(jsonData), &user)
if err != nil {
    log.Fatal(err)
}
fmt.Printf("%+v\n", user) // 输出：{Name:Alice Age:25 Email:}

使用 map 处理动态JSON对象

当JSON结构不固定或字段未知时，可用 map[string]interface{} 接收。

var data map[string]interface{}
err := json.Unmarshal([]byte(jsonData), &data)
if err != nil {
    log.Fatal(err)
}
fmt.Println(data["name"]) // 输出 Alice

注意：嵌套对象也会被解析为 map[string]interface{}，访问时需类型断言。

处理JSON数组

JSON数组可解析为切片。若元素是对象，可使用结构体切片或 []map[string]interface{}。

type Product struct {
    ID    int     `json:"id"`
    Name  string  `json:"name"`
    Price float64 `json:"price"`
}

jsonData := `[{"id":1,"name":"Laptop","price":999.9},{"id":2,"name":"Mouse","price":25.5}]`
var products []Product
err := json.Unmarshal([]byte(jsonData), &products)
if err != nil {
    log.Fatal(err)
}
for _, p := range products {
    fmt.Printf("产品: %s, 价格: %.2f\n", p.Name, p.Price)
}

var items []map[string]interface{}
err := json.Unmarshal([]byte(jsonData), &items)
if err != nil {
    log.Fatal(err)
}
for _, item := range items {
    fmt.Println("名称:", item["name"])
}

序列化结构体或map为JSON

使用 json.Marshal 将Go数据转换为JSON字节流。

user := User{Name: "Bob", Age: 30}
data, err := json.Marshal(user)
if err != nil {
    log.Fatal(err)
}
fmt.Println(string(data)) // 输出：{"name":"Bob","age":30,"email":""}

// 格式化输出（带缩进）
data, _ = json.MarshalIndent(user, "", "  ")
fmt.Println(string(data))

基本上就这些。关键是根据数据是否固定选择结构体还是map，合理使用 tag 控制字段行为。处理数组时注意目标类型的匹配。不复杂但容易忽略细节，比如指针传递和类型断言。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang处理JSON数组与对象方法详解》文章吧，也可关注golang学习网公众号了解相关技术文章。