当前位置：首页 > 文章列表 > Golang > Go教程 > GolangJSON处理：解析与生成教程详解

GolangJSON处理：解析与生成教程详解

2025-08-06 22:05:31 0浏览收藏

各位小伙伴们，大家好呀！看看今天我又给各位带来了什么文章？本文标题是《Golang处理JSON数据：解析与生成完整教程》，很明显是关于Golang的文章哈哈哈，其中内容主要会涉及到等等，如果能帮到你，觉得很不错的话，欢迎各位多多点评和分享！

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 中虽然不算特别简单，但只要结构清晰、标签写对，其实也挺顺手的。

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