Go语言通过encoding/json包实现JSON解析与生成，定义结构体时使用json标签映射字段，如UserName string json:"user_name"；处理HTTP请求时用json.NewDecoder(r.Body).Decode(&req)解析JSON到结构体，需校验请求方法和Content-Type；返回响应时用json.NewEncoder(w).Encode(data)输出JSON，设置Content-Type为application/json；可使用map[string]interface{}处理动态JSON，但性能较低；推荐封装通用响应函数并注意零值、omitempty及错误处理，确保服务稳定。
在Go语言开发中，处理JSON数据是Web服务最常见的任务之一。无论是接收客户端传来的JSON请求体，还是返回结构化的JSON响应，Golang都提供了简洁高效的内置支持。通过 encoding/json 包，你可以轻松完成JSON的解析（反序列化）与生成（序列化）。
定义结构体映射JSON
要正确解析或生成JSON，第一步是定义与JSON格式匹配的Go结构体。结构体字段需以大写字母开头，并通过 json标签 控制键名映射。
<span style="color:#008000;">// 请求示例：{ "user_name": "alice", "age": 25 }</span>
<span style="color:#0000ff;">type</span> UserRequest <span style="color:#0000ff;">struct</span> {
UserName <span style="color:#0000ff;">string</span> `json:<span style="color:#a31515;">"user_name"</span>`
Age <span style="color:#0000ff;">int</span> `json:<span style="color:#a31515;">"age"</span>`
}
<span style="color:#008000;">// 响应示例：{ "success": true, "message": "ok" }</span>
<span style="color:#0000ff;">type</span> Response <span style="color:#0000ff;">struct</span> {
Success <span style="color:#0000ff;">bool</span> `json:<span style="color:#a31515;">"success"</span>`
Message <span style="color:#0000ff;">string</span> `json:<span style="color:#a31515;">"message"</span>`
}
解析JSON请求体
在HTTP处理器中，使用 json.NewDecoder 从请求体读取并解析JSON数据到结构体。
<span style="color:#0000ff;">func</span> handleLogin(w http.ResponseWriter, r *http.Request) {
<span style="color:#0000ff;">if</span> r.Method != <span style="color:#a31515;">"POST"</span> {
http.Error(w, <span style="color:#a31515;">"method not allowed"</span>, http.StatusMethodNotAllowed)
<span style="color:#0000ff;">return</span>
}
<span style="color:#0000ff;">var</span> req UserRequest
<span style="color:#0000ff;">if</span> err := json.NewDecoder(r.Body).Decode(&req); err != nil {
http.Error(w, err.Error(), http.StatusBadRequest)
<span style="color:#0000ff;">return</span>
}
<span style="color:#008000;">// 处理逻辑...</span>
}
- 确保检查请求方法和Content-Type头
- 解码失败时返回400错误，便于前端调试
- 及时关闭r.Body（通常由框架自动处理）
返回JSON响应
使用 json.NewEncoder 将结构体编码为JSON并写入响应流。
Golang Google Wire
下载
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
立即学习“go语言免费学习笔记（深入）”；
<span style="color:#0000ff;">func</span> sendResponse(w http.ResponseWriter, data <span style="color:#0000ff;">interface</span>{}) {
w.Header().Set(<span style="color:#a31515;">"Content-Type"</span>, <span style="color:#a31515;">"application/json"</span>)
<span style="color:#0000ff;">if</span> err := json.NewEncoder(w).Encode(data); err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
}
}
<span style="color:#008000;">// 在处理器中调用</span>
sendResponse(w, Response{
Success: <span style="color:#0000ff;">true</span>,
Message: <span style="color:#a31515;">"login successful"</span>,
})
- 设置正确的Content-Type防止前端解析错误
- 结构体字段为零值时也会被输出，可用指针或omitempty控制
- 推荐封装通用响应函数提升代码复用性
处理动态或未知结构
当无法预定义结构体时，可使用 map[string]interface{} 或 interface{} 接收任意JSON对象。
<span style="color:#0000ff;">var</span> raw map[string]<span style="color:#0000ff;">interface</span>{}
json.NewDecoder(r.Body).Decode(&raw)
name := raw[<span style="color:#a31515;">"user_name"</span>].(<span style="color:#0000ff;">string</span>)
- 类型断言需谨慎，建议配合ok判断避免panic
- 适用于配置解析、Webhook等场景
- 性能低于结构体，不推荐高频接口使用
基本上就这些。掌握结构体标签、NewDecoder/Encoder的使用，以及常见边界处理，就能在Golang项目中高效应对大多数JSON场景。不复杂但容易忽略的是错误处理和Header设置，保持严谨才能构建稳定服务。
