go-playground/validator 是 Go 字段校验事实标准，依赖 struct tag、不侵入业务；需手动调 Validate 方法，tag 逗号前后禁空格，嵌套用点号，nil 指针需 nilable，slice/map 零值需区分处理，预编译可降耗 30%+。
用 validator 包 + struct tag 是最稳的路径
Go 原生不带字段校验，靠反射实现的第三方库里，go-playground/validator 是事实标准。它不侵入业务逻辑，只依赖 struct tag（比如 json 那套风格），和 Go 的惯用法贴合度高。
常见错误是手动写反射循环判断——既难维护又容易漏边界（比如嵌套结构、指针解引用、零值处理）。用现成 validator 能直接避开这些坑。
- 安装：
go get github.com/go-playground/validator/v10 - 必须用
Validate方法触发校验，不是自动的；struct 实例本身不感知 tag - tag 名默认是
validate，不是json或gorm，别混用 - 如果字段是
*string类型且为nil，required会失败，但omitempty不影响其他规则生效
StructTag 写法决定校验行为，空格和逗号不能错
tag 字符串解析很脆弱：多一个空格、少一个逗号，validator 就静默忽略该规则。它不报错，但也不生效——这是最常被卡住的地方。
例如 `validate:"required,min=3,max=20"` 合法；而 `validate:"required, min=3"`（逗号后有空格）会导致 min 被跳过。
立即学习“go语言免费学习笔记（深入）”；
- 所有规则用英文逗号分隔，**逗号前后都不能有空格**
- 嵌套结构用点号访问：
Address.Street→ tag 写在Address字段上，用validate:"required"即可，不用展开 - 自定义错误消息要配
SetErrorTag，默认只返回 key（如"Key: 'User.Name' Error:Field validation for 'Name' failed on the 'required' tag"） - 时间类型校验要用
datetime规则，且必须指定 layout：validate:"datetime=2006-01-02"
指针、slice、map 的零值处理最容易翻车
validator 对 nil 指针默认跳过校验（除非显式加 nilable），但 slice 和 map 的 nil 和空是两回事——required 只管是否为 nil，不管 len 是否为 0。
比如一个 []string 字段，传了 nil 会触发 required 失败；但如果传了 []string{}（空 slice），required 通过，但你可能真正想要的是 min=1。
-
required对*T类型只检查指针是否为 nil，不检查*T指向的值 - 校验 slice 长度用
min=1或len=5，别依赖required - map 必须用
required判 nil，再用min=1判非空，两者缺一不可 - 嵌套 struct 中字段为
nil时，外层required不会递归触发内层校验，得手动调Struct方法
性能敏感场景下，提前编译校验器能省 30%+ 开销
每次调 Validate.Struct 都会动态解析 tag、构建校验规则树。对高频接口（比如每秒上千次的 API 入参校验），这部分反射开销明显。
用 validatorInstance.RegisterValidation 配合 StructLevel 可以注册全局规则，但更关键的是复用 validator 实例 + 预编译：
- 全局只初始化一个
*validator.Validate实例，不要每次 new - 用
validatorInstance.Cached（v10.12+）或自己缓存StructValidator，避免重复解析同一 struct 类型 - 自定义验证函数注册一次即可，重复注册会 panic
- benchmark 显示：对固定 struct 类型，预编译后单次校验耗时从 ~800ns 降到 ~500ns
反射校验永远比硬编码慢，但慢多少，取决于你有没有把 tag 解析、规则构建这些“一次性工作”挪到启动期。上线前跑下 go test -bench，tag 解析占不占大头，一眼就知道。
