当前位置：首页 > 文章列表 > Golang > Go教程 > Golang解析与生成JSON数据全攻略

Golang解析与生成JSON数据全攻略

2025-07-28 12:10:29 0浏览收藏

本文全面解析了 Golang 如何处理 JSON 数据，为开发者提供了详尽的教程。文章重点介绍了 `encoding/json` 包的核心用法，包括如何将 JSON 字符串解析为 Go 结构体，以及如何将 Go 结构体序列化为 JSON 字符串。针对实际开发中常见的场景，例如嵌套结构和动态 JSON，文章也给出了相应的处理方案和代码示例。此外，还总结了处理 JSON 数据时需要注意的常见问题，例如字段名大小写、时间字段处理、空值处理以及错误检查，旨在帮助开发者快速掌握 Golang 中 JSON 数据的解析与生成技巧，提升 Web 应用和 API 接口的开发效率。

Go语言处理JSON数据的核心方法是使用encoding/json包。解析JSON字符串需定义对应结构体并用json.Unmarshal，注意字段首字母大写及标签映射；结构体转JSON用json.Marshal或json.MarshalIndent；嵌套结构需定义对应嵌套结构体；动态JSON可用map[string]interface{}接收；注意事项包括字段导出、时间处理、空值忽略及错误检查。

怎样用Golang处理JSON数据解析与生成JSON的完整示例

处理 JSON 数据是 Go 语言中非常常见的任务，特别是在开发 Web 应用或 API 接口时。Golang 标准库中的 encoding/json 包提供了完整的解析和生成 JSON 的功能。下面通过几个常见场景，带你快速掌握怎么用 Golang 处理 JSON。

解析 JSON 字符串到结构体

在实际开发中，我们经常需要将接收到的 JSON 数据转换成 Go 中的结构体（struct），以便于后续操作。

比如有如下 JSON 字符串：

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

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

package main

import (
    "encoding/json"
    "fmt"
)

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 {
        fmt.Println("解析失败:", err)
        return
    }

    fmt.Printf("%+v\n", user)
}

几点注意：

结构体字段名最好首字母大写，否则无法被正确赋值。
使用标签（tag）来指定 JSON 字段名，这样即使结构体字段名不同也能正确映射。

将结构体生成 JSON 字符串

反过来，我们也可以把 Go 的结构体数据序列化为 JSON 字符串，用于接口返回或者日志输出。

继续上面的例子：

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

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

输出结果就是标准的 JSON 格式：

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

如果你希望输出格式更美观，可以使用 json.MarshalIndent：

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

处理嵌套结构和动态 JSON

有时候 JSON 数据结构比较复杂，比如包含嵌套对象或者数组，这时候就需要定义嵌套结构体来匹配。

例如这个 JSON：

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

对应的结构体可以这样写：

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

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

解析方式与前面一致，只是结构变复杂了而已。

如果遇到不确定结构的 JSON，比如某些字段可能缺失或类型不固定，可以用 map[string]interface{} 或者 interface{} 类型来接收：

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

这种方式灵活性高，但牺牲了一定的类型安全性，适合做中间层处理。

常见问题和注意事项

字段名大小写影响：只有导出字段（首字母大写）才会参与 JSON 编解码。
时间字段处理：如果是 time.Time 类型，默认会转成 RFC3339 时间格式，你也可以自定义格式。
空值处理：结构体字段为空时，生成的 JSON 默认也会保留该字段，如需忽略空值可以在 tag 后加 omitempty，例如：json:"email,omitempty"。
错误处理很重要：特别是从网络读取 JSON 时，一定要检查 Unmarshal 是否出错。

基本上就这些内容了。JSON 处理在 Golang 中虽然不算特别简单，但只要结构清晰、标签写对，其实也挺顺手的。

好了，本文到此结束，带大家了解了《Golang解析与生成JSON数据全攻略》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！