为什么 Gin 的 JSON 处理如此重要？
在现代 Web 开发中，JSON 是前后端通信的事实标准。作为 Go 领域最流行的 Web 框架，Gin 对 JSON 的支持极为完善——无论是返回结构化响应，还是解析并验证请求数据，都只需几行代码。
JSON 响应 - c.JSON()
1. 基本用法
r.GET("/users",func(c*gin.Context){// 使用 gin.H（map[string]interface{} 的便捷写法）c.JSON(200,gin.H{"message":"success","data":[]gin.H{{"id":1,"name":"Alice"},{"id":2,"name":"Bob"},},"total":2,})})// 返回: {"message":"success","data":[{"id":1,"name":"Alice"},{"id":2,"name":"Bob"}],"total":2}2. 返回结构体
typeUserstruct{IDint`json:"id"`Namestring`json:"name"`Ageint`json:"age"`}r.GET("/user/:id",func(c*gin.Context){user:=User{ID:123,Name:"John",Age:25,}c.JSON(200,user)// 直接返回结构体})// 返回: {"id":123,"name":"John","age":25}3. 返回切片
r.GET("/users",func(c*gin.Context){users:=[]User{{ID:1,Name:"Alice",Age:23},{ID:2,Name:"Bob",Age:28},}c.JSON(200,users)})// 返回: [{"id":1,"name":"Alice","age":23},{"id":2,"name":"Bob","age":28}]JSON 绑定 - 从请求体解析
1. c.ShouldBindJSON()
typeCreateUserRequeststruct{Namestring`json:"name" binding:"required"`Emailstring`json:"email" binding:"required,email"`Ageint`json:"age" binding:"required,min=1,max=120"`}r.POST("/users",func(c*gin.Context){varreq CreateUserRequest// 从请求体解析 JSON 到结构体iferr:=c.ShouldBindJSON(&req);err!=nil{c.JSON(400,gin.H{"error":"Validation failed","detail":err.Error(),})return}// 处理业务逻辑c.JSON(201,gin.H{"message":"User created successfully","user":req,})})结构体标签
1. json 标签
typeUserstruct{IDint`json:"id"`// JSON 字段名Namestring`json:"user_name"`// JSON 中字段名为 "user_name"Emailstring`json:"email"`// JSON 中字段名为 "email"Ageint`json:"-"`// 忽略该字段（不会出现在 JSON 中）}2. binding 标签（验证规则）
typeUserstruct{Namestring`json:"name" binding:"required"`// 必需Emailstring`json:"email" binding:"required,email"`//必需且是邮箱Ageint`json:"age" binding:"required,min=1,max=120"`//必需且在1-120之间Passwordstring`json:"password" binding:"required,min=6"`//必需且至少6位Phonestring`json:"phone" binding:"omitempty,e164"`// 可选，但如果有必须是E164 格式Statusstring`json:"status" binding:"oneof=active inactive"`//必须是指定值之一CreatedAtstring`json:"created_at" binding:"required,datetime=2006-01-02"`// 日期格式}其他绑定方法
1. c.ShouldBind() - 自动检测内容类型
r.POST("/users",func(c*gin.Context){varreq CreateUserRequest// 自动检测 Content-Type，支持 JSON、XML、YAML、Formiferr:=c.ShouldBind(&req);err!=nil{c.JSON(400,gin.H{"error":err.Error()})return}c.JSON(201,req)})2. c.ShouldBindWith() - 指定绑定方式
r.POST("/users",func(c*gin.Context){varreq CreateUserRequest// 明确指定使用 JSON 绑定iferr:=c.ShouldBindWith(&req,binding.JSON);err!=nil{c.JSON(400,gin.H{"error":err.Error()})return}c.JSON(201,req)})3. c.MustBindWith() - 必须绑定（失败返回 400）
r.POST("/users",func(c*gin.Context){varreq CreateUserRequest// 必须绑定成功，失败时自动返回 400 错误iferr:=c.MustBindWith(&req,binding.JSON);err!=nil{// 这里 err 一定是验证错误return// 不需要手动处理错误}c.JSON(201,req)})JSON 绑定完整示例
typeUserstruct{IDuint`json:"id" binding:"omitempty"`//创建时可选，更新时必需Namestring`json:"name" binding:"required,min=2,max=32"`Emailstring`json:"email" binding:"required,email"`Ageint`json:"age" binding:"required,min=1,max=120"`Passwordstring`json:"password" binding:"required,min=6"`Statusstring`json:"status" binding:"oneof=active inactive"`CreatedAt time.Time`json:"created_at" binding:"omitempty"`}funcmain(){r:=gin.Default()// 创建用户r.POST("/users",func(c*gin.Context){varuser Useriferr:=c.ShouldBindJSON(&user);err!=nil{c.JSON(400,gin.H{"error":"Validation failed","details":err.Error(),})return}// 模拟创建用户（实际项目中会保存到数据库）user.ID=123// 假设这是新创建的 IDuser.CreatedAt=time.Now()c.JSON(201,gin.H{"message":"User created successfully","user":user,})})// 批量创建用户r.POST("/users/batch",func(c*gin.Context){varusers[]Useriferr:=c.ShouldBindJSON(&users);err!=nil{c.JSON(400,gin.H{"error":err.Error()})return}c.JSON(201,gin.H{"message":"Users created successfully","count":len(users),"users":users,})})r.Run()}
