validator库需满足字段导出、结构体合规等前提才生效；小写字段被静默跳过；嵌套校验需指针+omitempty；勿混用Validate.Struct()与Validate.Var()；Gin需手动升级至validator/v10实例。
validator 库不是“开了就能用”的魔法开关，它只在校验入口正确、结构体定义合规、字段可导出、嵌套控制得当的前提下才真正生效。直接贴 validate:"required" 却收不到错误，八成是字段小写、指针未判空、或把 Validate.Var() 误当 Validate.Struct() 用了。
字段必须首字母大写，否则 validator 完全不看
validator 依赖反射读取字段值，只能访问导出字段（即首字母大写）。小写字段哪怕 tag 写得再全，也会被静默跳过——不报错、不校验、不提醒。
- 错误写法：
type User struct { name string `validate:"required"` }→name不参与任何校验 - 正确写法：
type User struct { Name string `validate:"required"` } - 对接 JSON 时别混淆：
json:"user_name"是序列化映射，不影响字段是否导出；结构体字段名仍需大写 - 嵌套结构体同理：内层
Child的字段也必须大写，否则Child.Name不会被校验
嵌套结构体校验失效？检查 omitempty 和指针初始化
validator 默认对非 nil 的嵌套结构体做深度校验，哪怕子结构体所有字段都是零值（如 Age: 0, Name: ""），也会进去检查子字段的 required。这不是 bug，是设计行为。
- 想让空对象跳过子校验，必须用
omitempty标签：Child *Child `validate:"omitempty"`（注意是*Child指针） -
omitempty只对指针、接口、map、slice、chan、func 有效；普通 struct 字段即使为空也会进子校验 - 如果字段是
*Child类型，传nil就跳过；但若传了非 nil 指针，哪怕它指向一个全零值的Child{}，子字段仍会校验 - 校验前务必确保指针字段已初始化或明确为
nil，避免反序列化后出现 “非 nil 但内部全空” 的中间态
Validate.Struct() 和 Validate.Var() 别混用
两者用途完全不同：Validate.Struct() 走完整字段标签解析和嵌套递归逻辑；Validate.Var() 只校验单个值，完全不感知结构体上下文。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 把
*User传给Validate.Var()→ 只判断指针是否为nil，不会跑任何字段校验 - 想校验整个请求体，一律用
Validate.Struct(req)，且必须先判空：if req == nil { return errors.New("request is nil") }，否则 panic - 仅在动态取值场景（比如从
map[string]string里取某个 key）才用Validate.Var(value, "required,email") - 时间字段不能直接校验
time.Time：零值是0001-01-01，required不触发；应转为字符串字段 +datetime=2006-01-02规则
Gin 中 validator 失效？你可能还在用 v9 实例
Gin 默认绑定的是 validator/v9，而社区主流已是 v10。v10 新增了 dive、structonly、更严格的 tag 解析等特性，v9 不认这些规则，导致 tag 看似写了却静默失效。
- 必须手动替换 Gin 的 validator 实例：
engine.Validator = &defaultValidator{validator: v}，其中v是validator.New()创建的 v10 实例 - 别在中间件里统一调用
c.ShouldBind()后再校验——Gin 的 binding 已经触发过一次校验，重复调用Validate.Struct()可能因字段已修改而结果不一致 - query/path 参数不能依赖框架自动转换：如
chi.URLParam(r, "id")返回字符串，需手动strconv.ParseInt()并检查 error，再业务校验（如 > 0） - 不要信任默认值 fallback：传
page=（空字符串）就该报错，而不是悄悄设成 1
最常被忽略的一点：validator 本身不处理数据来源差异。JSON Body、Form、Query 三者字段映射逻辑不同，但校验入口都落在同一个 struct 上——这意味着你得自己确保每种来源的数据都能正确绑定到对应字段，尤其是带 json:、form:、url: tag 的字段别写串了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
