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

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,而非结构体本身
示例:
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










