Golang生成JSON数据详解教程

本文深入讲解了如何在 Golang 中高效解析和生成 JSON 数据，助力 Web 开发和 API 接口交互。文章从最常用的 JSON 字符串到结构体解析入手，详细介绍了如何利用 `json.Unmarshal` 将 JSON 数据转换为 Go 结构体，并强调了结构体字段导出和 JSON 标签的重要性。同时，也涵盖了结构体转 JSON 字符串的方法，包括使用 `json.Marshal` 生成紧凑格式和 `json.MarshalIndent` 生成易读的缩进格式。针对嵌套和复杂 JSON 结构，本文提供了定义嵌套结构体的解决方案。此外，还介绍了使用 `map[string]interface{}` 处理未知结构 JSON 数据的方法，并提醒了类型断言的注意事项。掌握这些技巧，能让你在 Golang 中轻松应对各种 JSON 数据处理场景。

如何在Go语言中操作JSON数据？1.解析JSON字符串为结构体：使用json.Unmarshal将JSON字符串转换为结构体变量，需定义字段匹配的导出结构体并使用json标签；2.结构体转JSON字符串：用json.Marshal生成紧凑格式或json.MarshalIndent生成带缩进的可读格式；3.处理嵌套结构：通过定义嵌套结构体匹配JSON层级，支持数组和子对象；4.处理未知结构：使用map[string]interface{}配合类型断言访问动态数据，适用于不确定字段的情况。

处理 JSON 数据是 Go 语言中非常常见的任务，特别是在做 Web 开发或者 API 接口交互时。Golang 提供了标准库 encoding/json 来支持对 JSON 的解析和生成，使用起来既方便又高效。

下面通过几个常见场景，带你一步步掌握如何在 Golang 中操作 JSON 数据。

如何将 JSON 字符串解析为结构体

这是最常用的一种情况：你拿到了一段 JSON 格式的字符串，想要把它转换成 Go 中的结构体变量来使用。

假设我们有如下 JSON：

{
  "name": "Tom",
  "age": 25,
  "email": "tom@example.com"
}

我们可以定义一个对应的结构体，并用 json.Unmarshal 进行解析：

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

func main() {
    data := `{"name":"Tom","age":25,"email":"tom@example.com"}`
    var user User
    err := json.Unmarshal([]byte(data), &user)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("%+v\n", user)
}

注意几点：

• 结构体字段需要导出（首字母大写）
• 使用反引号标记 JSON 字段名，匹配大小写
• 如果不确定结构，也可以用 map[string]interface{} 替代结构体

怎么把结构体转成 JSON 字符串

有时候我们需要把 Go 中的数据结构变成 JSON 字符串，比如返回给前端接口或写入文件。

继续用上面的 User 结构体为例：

user := User{
    Name:  "Jerry",
    Age:   30,
    Email: "jerry@example.com",
}

jsonData, _ := json.Marshal(user)
fmt.Println(string(jsonData))

输出结果会是：

{"name":"Jerry","age":30,"email":"jerry@example.com"}

如果你想让输出更易读，可以使用 json.MarshalIndent：

jsonData, _ := json.MarshalIndent(user, "", "  ")

这样输出的 JSON 会有缩进格式，适合调试查看。

解析嵌套和复杂结构的 JSON

实际开发中，JSON 往往比较复杂，比如包含数组、嵌套对象等。这时候就需要定义好对应的结构体层级。

例如这段 JSON：

{
  "id": 1,
  "name": "Alice",
  "hobbies": ["reading", "coding"],
  "address": {
    "city": "Beijing",
    "zip": "100000"
  }
}

对应的结构体应该是这样的：

type Address struct {
    City string `json:"city"`
    Zip  string `json:"zip"`
}

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

然后解析方式与前面一致，只需要注意结构体字段要一一对应即可。

如果某些字段可能缺失或类型不固定，可以用 omitempty 标签或者使用 interface{} 类型，但需要注意后续类型断言的问题。

处理未知结构的 JSON 数据

如果你拿到的 JSON 结构不固定或者你事先不知道具体结构，可以使用 map[string]interface{} 或者 interface{} 配合类型断言进行处理。

比如：

var data map[string]interface{}
json.Unmarshal(jsonBytes, &data)

之后你可以通过 key 来访问：

name := data["name"].(string)
age := data["age"].(float64) // JSON 中数字默认是 float64

这种方式灵活但容易出错，建议只在确实无法预知结构时使用，否则还是推荐使用结构体。

基本上就这些。Go 操作 JSON 的方法虽然简单，但很多细节比如标签使用、类型转换、结构匹配都需要特别注意。只要多练习几次，很快就能熟练上手。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~