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标签 控制键名映射。
// 请求示例：{ "user_name": "alice", "age": 25 } type UserRequest struct { UserName string `json:"user_name"` Age int `json:"age"` } // 响应示例：{ "success": true, "message": "ok" } type Response struct { Success bool `json:"success"` Message string `json:"message"` }
解析JSON请求体
在HTTP处理器中，使用 json.NewDecoder 从请求体读取并解析JSON数据到结构体。
func handleLogin(w http.ResponseWriter, r *http.Request) { if r.Method != "POST" { http.Error(w, "method not allowed", http.StatusMethodNotAllowed) return } var req UserRequest if err := json.NewDecoder(r.Body).Decode(&req); err != nil { http.Error(w, err.Error(), http.StatusBadRequest) return } // 处理逻辑... }
- 确保检查请求方法和Content-Type头
- 解码失败时返回400错误，便于前端调试
- 及时关闭r.Body（通常由框架自动处理）
返回JSON响应
使用 json.NewEncoder 将结构体编码为JSON并写入响应流。
立即学习“go语言免费学习笔记（深入）”；
func sendResponse(w http.ResponseWriter, data interface{}) { w.Header().Set("Content-Type", "application/json") if err := json.NewEncoder(w).Encode(data); err != nil { http.Error(w, err.Error(), http.StatusInternalServerError) } } // 在处理器中调用 sendResponse(w, Response{ Success: true, Message: "login successful", })
- 设置正确的Content-Type防止前端解析错误
- 结构体字段为零值时也会被输出，可用指针或omitempty控制
- 推荐封装通用响应函数提升代码复用性
处理动态或未知结构
当无法预定义结构体时，可使用 map[string]interface{} 或 interface{} 接收任意JSON对象。
var raw map[string]interface{} json.NewDecoder(r.Body).Decode(&raw) name := raw["user_name"].(string)
- 类型断言需谨慎，建议配合ok判断避免panic
- 适用于配置解析、Webhook等场景
- 性能低于结构体，不推荐高频接口使用
基本上就这些。掌握结构体标签、NewDecoder/Encoder的使用，以及常见边界处理，就能在Golang项目中高效应对大多数JSON场景。不复杂但容易忽略的是错误处理和Header设置，保持严谨才能构建稳定服务。
