Golang JSON序列化入门实践指南

**Golang JSON序列化入门实践指南：掌握技巧提升开发效率** 在Golang项目中，JSON数据的处理至关重要，尤其是在API服务构建和配置文件读写中。本文深入探讨Golang的`encoding/json`包，助你轻松实现JSON的序列化与反序列化。通过结构体标签，灵活控制字段映射和输出行为，如`omitempty`忽略零值、`-`忽略字段等。本文将详细讲解如何利用`json.Marshal`和`json.Unmarshal`进行数据转换，并提供处理动态JSON的实用技巧，例如使用`map[string]interface{}`。掌握这些Golang JSON处理的核心概念和技巧，能有效提升你的开发效率和代码可维护性。

Go通过encoding/json包实现JSON处理，使用struct标签映射字段，json.Marshal/Unmarshal进行序列化与反序列化，支持omitempty、-等标签控制输出行为，结构体字段需大写开头，可结合map[string]interface{}处理动态JSON。

在Golang入门项目中，处理JSON数据是常见需求，尤其在构建API服务或读写配置文件时。Go语言通过encoding/json包提供了强大且简洁的JSON序列化与反序列化能力。掌握其基本用法和常见技巧，能有效提升开发效率和代码可维护性。

结构体与JSON字段映射

Go中通常使用结构体（struct）来表示JSON数据结构。通过结构体标签（struct tag），可以控制字段在JSON中的名称、是否忽略等行为。

例如，定义一个用户信息结构体：

type User struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
    Email string `json:"email"`
    Age  int    `json:"age,omitempty"`
    Password string `json:"-"`
}

说明：

• json:"id"：将结构体字段ID序列化为JSON中的"id"
• omitempty：当Age字段为零值（如0）时，不会出现在JSON输出中
• json:"-"：Password字段不会被序列化，常用于敏感信息

序列化：结构体转JSON

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

user := User{
    ID:   1,
    Name: "Alice",
    Email: "alice@example.com",
    Age:  25,
    Password: "secret",
}
data, err := json.Marshal(user)
if err != nil {
    log.Fatal(err)
}
fmt.Println(string(data))
// 输出：{"id":1,"name":"Alice","email":"alice@example.com","age":25}

如果希望输出格式更易读，可使用json.MarshalIndent()：

data, _ := json.MarshalIndent(user, "", "  ")
fmt.Println(string(data))

反序列化：JSON转结构体

使用json.Unmarshal()将JSON数据解析到结构体中。

jsonStr := `{"id":2,"name":"Bob","email":"bob@example.com"}`
var user2 User
err := json.Unmarshal([]byte(jsonStr), &user2)
if err != nil {
    log.Fatal(err)
}
fmt.Printf("%+v\n", user2)
// 输出：{ID:2 Name:Bob Email:bob@example.com Age:0 Password:}

注意：

• 传入结构体的指针，否则无法修改原始值
• JSON中的字段必须能匹配结构体字段（通过json tag或字段名）
• 未定义的字段会被忽略，不会报错

处理动态或未知结构JSON

当JSON结构不固定时，可以使用map[string]interface{}或interface{}。

var data map[string]interface{}
json.Unmarshal([]byte(jsonStr), &data)
fmt.Println(data["name"]) // 输出：Bob

遍历动态JSON：

for k, v := range data {
    fmt.Printf("%s: %v (%T)\n", k, v, v)
}

常见类型对应关系：

• JSON数字 → float64（注意不是int）
• JSON字符串 → string
• JSON布尔值 → bool
• JSON对象 → map[string]interface{}
• JSON数组 → []interface{}

本篇关于《Golang JSON序列化入门实践指南》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！