讲师中心 微信公众号
AI工具推荐 视频效率加速

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

轻明吖_3350

轻明吖_3350

发布时间:2025-12-17 10:39:46

|

405人浏览过

|

来源于php中文网

原创

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语言免费学习笔记(深入)”;

Node.js 可靠编程
Node.js 可靠编程

Node.js 可靠编程技能。避免事件循环阻塞、异步陷阱、ESM 兼容问题和内存泄漏。触发词:Node.js 开发、async/await、流处理、性能优化、安全编码。

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

示例:

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

热门AI工具

更多
讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

539

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

616

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1236

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

791

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1806

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

5174

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

2394

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

4266

2025.06.17

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

0

2026.11.05

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.3万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn