应优先使用ShouldBind：它仅在解析失败（如JSON格式错误、类型不匹配）时返回error；校验失败（如required未满足）则存入结构体字段的Err中，需手动检查。
怎么用 Bind 和 ShouldBind 区分校验失败原因
直接调 Bind 会把参数解析失败和校验失败混成一个错误，比如用户传了非数字的 id，你没法知道是类型错了还是没满足 required。这时候该用 ShouldBind —— 它只在解析失败（如 JSON 格式错、字段类型不匹配）时返回 error；而校验失败（如 binding:"required" 不通过）则写进结构体字段的 Err 里，靠 err != nil 判断不到。
实操建议：
- 统一用
ShouldBind，再手动检查结构体字段的Err字段（需提前在 struct tag 里加msg提示） - 不要依赖
BindJSON的 error 做业务逻辑分支，它可能掩盖真实问题 - 如果只是简单取值、不做校验，用
c.Query或c.PostForm更轻量，不触发反射和 validator
c.Param、c.Query、c.PostForm 什么时候该用哪个
URL 路径里的 /user/:id 用 c.Param("id")；问号后的 ?page=2 用 c.Query("page")；表单或 application/x-www-form-urlencoded 用 c.PostForm("name")。三者互不覆盖，也不会自动 fallback —— 比如你用 c.Query("id") 去拿路径参数，永远是空字符串。
常见错误现象：
立即学习“go语言免费学习笔记（深入）”；
- 前端发了 JSON body，却用
c.PostForm取值 → 返回空，且无报错 - 路由定义是
/api/v1/:version/users，但代码里写c.Param("v")→ 拿不到，别名必须和冒号后完全一致 - Query 参数带空格或特殊字符（如
q=go%20lang），c.Query自动解码，但c.Request.URL.Query().Get不会 → 后者拿到的是原始编码串
Gin 的 binding tag 在 struct 中为什么有时不生效
根本原因是：Gin 默认只对导出字段（首字母大写）做绑定。如果你写了 type User struct { name string }，哪怕加了 json:"name" binding:"required"，ShouldBind 也完全忽略这个字段 —— 它压根不会反射进去。
实操建议：
- 所有要绑定的字段必须首字母大写，比如
Name string -
binding:"required"对指针字段（*string）默认不强制非空，因为nil是合法值；要用binding:"required,nonzero" - 嵌套结构体要显式加
binding:"required"，否则外层字段为空时，内层校验不触发 - 时间字段用
time.Time+binding:"required,datetime=2006-01-02"，别依赖默认格式，否则容易解析失败
用 c.ShouldBindJSON 时遇到 invalid character 错误怎么办
这个错误不是 Gin 报的，是底层 encoding/json 解析失败。常见于前端发了带 BOM 的 UTF-8 JSON、多了一个逗号、用了单引号、或者字段名拼错了导致解析中断。Gin 不会帮你修复 JSON，只会原样透出底层 error。
排查步骤：
- 先打印
c.Request.Body（注意：读一次就没了，得用c.Request.Body = io.NopCloser(bytes.NewBuffer(buf))复位） - 用在线 JSON 校验工具（如 jsonlint.com）粘贴原始 body，看哪一行报错
- 检查前端是否用了
JSON.stringify但没设 header：Content-Type: application/json→ Gin 会跳过 JSON 绑定，走默认 form 解析 - 如果必须兼容脏数据，改用
json.Unmarshal手动解析，捕获json.SyntaxError做降级处理
最常被忽略的是：开发时用 curl 测试，忘了加 -H "Content-Type: application/json"，结果 Gin 当成普通表单处理，ShouldBindJSON 直接返回空 error，字段全为零值。
