怎样用Golang处理JSON数据解析与生成JSON的完整示例-Golang-PHP中文网

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

P粉602998670

发布： 2025-08-12 14:32:01

原创

786人浏览过

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 字符串：

立即学习“go语言免费学习笔记（深入）”；

{
  "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 格式：

AssemblyAI

转录和理解语音的AI模型

查看详情

{"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
```
登录后复制
是否出错。