如何在Golang中使用JSON解析与序列化_处理REST API数据-Golang-PHP中文网

如何在Golang中使用JSON解析与序列化_处理REST API数据

P粉602998670

发布： 2025-12-17 10:39:46

原创

385人浏览过

Go语言内置encoding/json包可高效解析和序列化JSON，只需定义带json标签的导出结构体，用json.Unmarshal解码HTTP响应，json.Marshal编码POST请求体，动态字段可用map[string]interface{}或json.RawMessage处理。

如何在golang中使用json解析与序列化_处理rest api数据

Go 语言内置的 encoding/json 包让 JSON 解析与序列化非常简洁高效，处理 REST API 数据时只需关注结构体定义和编码/解码逻辑，无需第三方库。

定义结构体匹配 JSON 数据结构

Go 中 JSON 序列化依赖结构体字段的可见性（首字母大写）和标签（json:"field_name"）。API 返回的 JSON 字段名通常为小写或带下划线，需用标签映射。

字段必须导出（大写开头），否则 json 包无法访问
使用 json:"name" 指定序列化后的键名；json:"name,omitempty" 表示该字段为空值时不输出
嵌套对象、切片、指针均可直接映射，Go 会自动递归处理

例如，解析 GitHub API 的用户信息：

type User struct {
    ID       int    `json:"id"`
    Login    string `json:"login"`
    Name     string `json:"name"`
    Email    string `json:"email,omitempty"`
    PublicRepos int `json:"public_repos"`
}

登录后复制

从 HTTP 响应中解析 JSON 数据

调用 REST API 后，用 json.Unmarshal 将响应体字节切片转为结构体。注意检查错误，并确保响应状态码正常。

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

先用 http.Get 或 http.Client.Do 发起请求
读取 Response.Body 到字节切片（推荐用 io.ReadAll）
传入结构体变量地址给 json.Unmarshal，而非结构体本身

示例：

Text-To-Pokemon口袋妖怪

输入文本生成自己的Pokemon，还有各种选项来定制自己的口袋妖怪

1487

查看详情

resp, err := http.Get("https://api.github.com/users/octocat")
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)
var user User
if err := json.Unmarshal(body, &user); err != nil {
    log.Fatal("JSON 解析失败:", err)
}
fmt.Printf("用户名: %s, 仓库数: %d\n", user.Login, user.PublicRepos)

登录后复制

将结构体序列化为 JSON 并发送 POST 请求

向 API 提交数据时，用 json.Marshal 把结构体转成 JSON 字节，再作为请求体发送。注意设置 Content-Type: application/json 头。

json.Marshal 返回 []byte 和 error，成功后可直接传给 bytes.NewReader
避免手动拼接 JSON 字符串，既易错又难维护
若需格式化输出（如调试），可用 json.MarshalIndent

示例（创建 issue）：

type IssueRequest struct {
    Title string `json:"title"`
    Body  string `json:"body"`
}

reqData := IssueRequest{
    Title: "Bug: 登录失败",
    Body:  "在 iOS Safari 上点击登录无响应",
}
payload, _ := json.Marshal(reqData)

client := &http.Client{}
httpReq, _ := http.NewRequest("POST", "https://api.github.com/repos/owner/repo/issues", bytes.NewReader(payload))
httpReq.Header.Set("Content-Type", "application/json")
httpReq.Header.Set("Authorization", "token YOUR_TOKEN")

resp, _ := client.Do(httpReq)
// 处理响应...

登录后复制

处理动态或不确定结构的 JSON

当 API 返回字段不固定（如混合类型、任意键名），可用 map[string]interface{} 或 json.RawMessage 延迟解析。

map[string]interface{} 适合快速提取几个已知字段，但类型断言较繁琐
json.RawMessage 是未解析的原始字节，适合嵌套结构延迟处理或透传
对部分字段不确定时，可组合使用：确定字段用结构体字段，动态部分用 json.RawMessage

例如处理 webhook 中的未知事件类型：

type WebhookEvent struct {
    EventType string          `json:"event"`
    Payload   json.RawMessage `json:"data"`
}

var event WebhookEvent
json.Unmarshal(data, &event)
// 根据 event.EventType 再决定如何解析 event.Payload

登录后复制

以上就是如何在Golang中使用JSON解析与序列化_处理REST API数据的详细内容，更多请关注php中文网其它相关文章！