GolangJSON序列化反序列化教程详解

你在学习Golang相关的知识吗？本文《Golang JSON序列化反序列化实战教程》，主要介绍的内容就涉及到，如果你想提升自己的开发能力，就不要错过这篇文章，大家要知道编程理论基础和实战操作都是不可或缺的哦！

定义结构体并使用json标签可实现Go语言中JSON的序列化与反序列化，通过json.Marshal将结构体转为JSON字符串（omitempty可省略空字段），json.Unmarshal将JSON数据解析到结构体，支持嵌套结构与切片，字段需导出（首字母大写）才能被正确处理。

在Go语言开发中，处理JSON数据是常见需求，尤其是在构建Web服务、API接口或微服务通信时。Go标准库encoding/json提供了强大且高效的JSON序列化与反序列化支持，无需引入第三方依赖即可完成大多数场景下的数据转换。

定义结构体以映射JSON数据

要实现JSON的序列化和反序列化，第一步是定义合适的结构体（struct）。结构体字段需使用标签（tag）来指定对应的JSON键名。

例如，描述一个用户信息：

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

说明：

• json:"id" 表示该字段在JSON中对应"id"键
• omitempty 表示当字段为空（如零值）时，序列化结果中将省略该字段

JSON序列化：结构体转JSON字符串

使用json.Marshal函数可将Go对象转换为JSON字节流。

user := User{
    ID:    1,
    Name:  "Alice",
    Age:   25,
    Email: "",
}

data, err := json.Marshal(user)
if err != nil {
    log.Fatal(err)
}
fmt.Println(string(data)) // 输出：{"id":1,"name":"Alice","age":25}

注意Email字段为空字符串，由于使用了omitempty，它没有出现在输出中。

若希望保留空字段，可直接调用json.Marshal，或确保字段有值。

JSON反序列化：JSON字符串解析为结构体

使用json.Unmarshal将JSON数据填充到结构体变量中。

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

只要JSON中的键能与结构体字段匹配（通过json tag），就能成功赋值。

对于未知结构或动态JSON，可以使用map[string]interface{}接收：

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

处理嵌套结构与切片

实际项目中JSON常包含数组或嵌套对象。Go结构体可通过嵌套定义支持这类结构。

type Address struct {
    City  string `json:"city"`
    State string `json:"state"`
}

type UserWithAddr struct {
    ID       int      `json:"id"`
    Name     string   `json:"name"`
    Hobbies  []string `json:"hobbies"`
    Address  Address  `json:"address"`
}

序列化和反序列化方式与简单结构一致，encoding/json会自动递归处理嵌套字段。

例如反序列化以下JSON：

{
  "id": 3,
  "name": "Charlie",
  "hobbies": ["reading", "coding"],
  "address": {
    "city": "Beijing",
    "state": "CN"
  }
}

只需调用Unmarshal即可完整映射到结构体。

基本上就这些。掌握结构体标签、Marshal/Unmarshal用法以及嵌套处理，就能应对大多数JSON操作场景。不复杂但容易忽略细节，比如字段必须导出（首字母大写）、正确使用omitempty等。

理论要掌握，实操不能落！以上关于《GolangJSON序列化反序列化教程详解》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！