go-playground/validator 是 go 中最常用结构体校验库，需通过 validate 标签定义规则、手动调用 validate.struct()，且依赖正确配置（如 gin 中替换默认 validator）、字段导出、类型预转换等关键实践。
Go-Playground/Validator 是 Go 生态中最常用、最灵活的结构体校验库，它不依赖 HTTP 框架，但能无缝集成到 Gin、Echo、Fiber 等主流框架中。关键在于：你得先定义好结构体标签，再调用 Validate.Struct()，而不是直接对 map 或 JSON 字符串校验——这是绝大多数新手卡住的第一步。
怎么给结构体字段加校验标签才生效
Validator 只认结构体字段上的 validate 标签，且默认忽略未导出字段（首字母小写）。标签值是逗号分隔的规则名，比如 required、email、min=1，大小写敏感，拼错就跳过校验。
常见错误现象：Validate.Struct() 返回 nil，但字段明明为空；其实是字段没加 validate 标签，或写了 valid 这种错别字。
- 必须用
json标签配合时，注意字段名映射一致性（比如 API 传user_name，结构体字段叫UserName，那json:"user_name"和validate:"required"要同时存在） - 嵌套结构体需手动递归校验，
validate:"required,structonly"不会自动展开子字段，得自己调Validate.Struct(child) - 指针字段加
validate:"required"仅校验指针是否非 nil；要校验指针指向的值，得用validate:"required,nonnil"（需启用Validate.StructExcept()或自定义函数）
Gin 中如何绑定并校验请求参数
Gin 的 c.ShouldBind() 默认不走 Validator，必须显式配置。最简方式是全局替换默认的 validator 实例，否则 binding:"required" 标签会被忽略，而 validate:"required" 完全不触发。
实操建议：
- 启动时调用
gin.SetMode(gin.ReleaseMode)后，立即执行gin.DefaultValidator = validator.New() - 结构体字段同时写
json:"name" validate:"required,email"，Gin 绑定时才会自动调用 Validator - 避免混用
c.Bind()（失败 panic）和c.ShouldBind()（失败返回 error），后者更可控 - 若用
c.ShouldBindQuery()或c.ShouldBindUri()，同样依赖上述 validator 替换，否则标签无效
自定义错误提示和字段名映射
默认错误信息是英文且带字段名（如 "Email is required"），但生产环境需要中文 + 更友好的键名（比如把 Email 显示为 "邮箱"）。不能靠字符串替换，得用 Translators 和 RegisterTagNameFunc。
关键点：
- 调用
v.RegisterTagNameFunc(func(fld reflect.StructField) string { return fld.Tag.Get("json") })，让错误里显示json名而非结构体字段名 - 中文翻译需注册
ut.RegisterTranslation()并实现ut.Translator接口，推荐用现成的go-playground/locales包（如zh_translations.RegisterDefaultTranslations(v, ut)） - 单个字段多规则报错时，默认只返回第一个；要收集全部，得用
v.StructCtx(ctx, obj)+err.(validator.ValidationErrors)类型断言遍历
为什么 validate:"omitempty,gt=0" 对零值字段没反应
omitempty 是 JSON 序列化行为，不是 Validator 规则。Validator 里真正起作用的是 omitempty 这个 tag option —— 它会让该字段在值为“空”（如 0、""、nil）时跳过后续所有规则校验。所以 gt=0 永远不会执行。
正确做法：
- 数值类型想表达“非零必校验”，去掉
omitempty，改用validate:"required,gt=0" - 字符串想表达“非空时才要求长度”，用
validate:"omitempty,min=3"—— 此时空字符串跳过min=3，但非空时强制至少 3 字符 - 切片/数组字段要注意：
[]string{""}不算空，omitempty不生效，len=0才算空
最易被忽略的是：Validator 不处理类型转换。前端传字符串 "123" 给 int 字段，Gin 默认会转成功，但如果你绕过 Gin 直接解析 JSON 再传给 Validate.Struct()，就得确保字段已是目标类型，否则校验永远不触发——它只校验类型正确的值。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
