gin绑定结构体依赖结构体tag与绑定方法精准匹配：form/query必须用form:"xxx"标签，json必须用json:"xxx"，uri参数必须用uri:"xxx"；用错tag或方法会导致字段零值或panic。
直接说结论：Gin 绑定结构体不是“自动映射”，而是靠结构体 tag + 绑定方法组合生效；用错 tag 或调错方法，字段就为空或 panic。
form 和 query 参数绑定必须用 form tag，不能只写 json
很多人定义结构体时只加 json:"xxx"，然后对 GET 请求用 c.ShouldBind(&s)，结果字段全是零值。这是因为 Gin 在 GET 或表单提交时（Content-Type: application/x-www-form-urlencoded）只看 form tag，完全忽略 json。
-
form:"name"表示从 URL 查询参数（?name=alice）或 POST 表单中取值 -
form:"name,default=guest"表示没传name时设默认值，注意 default 后不能有空格 - 复选框数组要写成
form:"colors[]"，对应前端<input name="colors[]"> - 如果结构体字段是嵌套指针（如
*string），默认值不生效，得靠业务层兜底
ShouldBindUri 只认 uri tag，且必须配合路由参数名
比如路由是 r.GET("/user/:id/:role", handler)，那结构体必须这么写：
type UserPath struct {
ID int `uri:"id" binding:"required"`
Role string `uri:"role" binding:"required,oneof=admin user"`
}
关键点：
-
uri:"id"的id必须和路由里:id完全一致，大小写敏感 -
ShouldBindUri不解析查询参数或请求体，只从 URL 路径段提取 - 数字类型（如
int）若路径里是非法字符串（如/user/abc/），会直接返回 400 错误，不会静默转成 0
JSON 绑定失败不报字段名，错误信息模糊怎么办
c.ShouldBindJSON(&s) 出错时，常见错误是 json: cannot unmarshal string into Go struct field X.Y of type int，但不告诉你具体哪个字段、哪条请求数据出问题。解决办法：
- 优先用
c.ShouldBindJSON而非c.ShouldBind，避免 Gin 自动 fallback 到 form 解析 - 结构体字段加
binding:"required"或binding:"min=1,max=100"，让验证提前暴露问题 - 调试时临时加日志：
body, _ := io.ReadAll(c.Request.Body); c.Request.Body = io.NopCloser(bytes.NewBuffer(body))，再打印body - 时间字段务必显式指定格式：
CreatedAt time.Time `json:"created_at" time_format:"2006-01-02T15:04:05Z07:00"`，否则默认只认 RFC3339
ShouldBind 和 ShouldBindJSON 的选择逻辑容易被忽略
c.ShouldBind 是“智能”方法：它先看 Content-Type，是 application/json 就走 JSON 解析，是 application/x-www-form-urlencoded 就走 form 解析。但这个行为在某些场景下反而坏事：
- POST 请求发了 JSON，但忘了设
Content-Type: application/json→ Gin 当作 form 处理，字段全空 - 前端用
fetch发 JSON 时默认不带Content-Type头 → 后端收不到数据 - 想强制走 JSON 解析，就别用
ShouldBind，直接上ShouldBindJSON，少一层猜测 - 同理，查 URL 参数就用
ShouldBindQuery，它只读c.Request.URL.Query()，不碰 body
最常被绕过的坑是：结构体字段没导出（小写开头），或者 tag 拼错（比如写成 from 而非 form），绑定器根本不会碰那个字段——它既不报错，也不赋值，安静地留着零值。检查时盯紧首字母和 tag 拼写。
