validator.RegisterValidation 是注册自定义规则的唯一入口，需传入规则名、校验函数（func(fl validator.FieldLevel) bool）和是否跨字段；规则名须与 struct tag 完全一致，否则不生效。
validator.RegisterValidation 是注册自定义规则的唯一入口
Go 的 go-playground/validator 不支持通过 struct tag 直接写逻辑，所有自定义校验必须先调用 validator.RegisterValidation 注册函数。这个函数接收三个参数：规则名（字符串）、校验函数、是否支持跨字段（通常传 false）。漏掉这一步，哪怕 tag 写对了也完全不生效。
- 校验函数签名必须是
func(fl validator.FieldLevel) bool，不能多参、不能返回 error - 规则名要和 struct tag 里写的完全一致（区分大小写），比如注册了
"phone"，tag 就得写validate:"phone" - 第二个参数设为
true时，fl可以调用fl.Top().FieldByName("xxx")访问其他字段，但多数单字段校验不需要
v := validator.New()
v.RegisterValidation("lte4", func(fl validator.FieldLevel) bool {
s, ok := fl.Field().Interface().(string)
if !ok {
return false
}
return len(s) <= 4
})
struct tag 中不能带括号或表达式，只认纯规则名
validate:"required,lte4" ✅validate:"required,lte4(4)" ❌ —— 这不是函数调用语法，validator 不解析括号内容validate:"required,lte4=4" ❌ —— 等号写法是旧版 v9 的遗留，v10+ 已废弃
如果真需要参数化（比如动态长度限制），得提前注册多个规则名，或者用 CustomTypeFunc + 自定义类型封装：
- 把
type MaxLen4 string和它的Validate() error方法绑定到validator.CustomTypeFunc - 或者注册
"len4"、"len8"、"len16"等固定规则，按需选用
自定义规则里访问 struct 字段值要用 Field().Interface()
fl.Field() 返回的是 reflect.Value，直接打印或比较会 panic。常见错误是写成：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
if fl.Field() == "abc"→ 类型不匹配，编译不过 -
if fl.Field().String() == "abc"→String()只对字符串类型安全，其他类型 panic
正确做法是先类型断言：
- 字符串：
s, ok := fl.Field().Interface().(string) - 整数：
i, ok := fl.Field().Interface().(int)或更通用的int64 - 指针字段要注意：如果 struct 字段是
<em>string</em>，Interface()返回的是string，需再解指针
另外，fl.Param() 可读取 tag 后面的参数（如 validate:"max=10" 中的 "10"），但前提是规则名本身是内置的（如 "max"）；自定义规则默认不解析 param，除非你自己在函数里调用 fl.Param() 并手动转换。
嵌套结构体或 slice 元素校验失败时，错误路径容易让人困惑
validator 默认把嵌套字段展开成点号路径，比如 User.Profile.Phone，但如果你在自定义规则里用了 fl.FieldName()，它只返回当前字段名（如 "Phone"），不是完整路径。调试时容易误判是哪个实例出错。
- 如果校验逻辑依赖上下文（比如“同一个用户下邮箱不能重复”），仅靠
fl不够，得用fl.Top()拿到根对象，再反射取其他字段 - slice 校验如
[]User，每个元素单独触发规则，fl.FieldName()仍是"Phone"，但fl.StructFieldName()会返回"Users"（即 slice 字段名），可辅助定位
实际项目中，建议在自定义函数开头加日志（开发期）：fmt.Printf("validating %s = %+v\n", fl.FieldName(), fl.Field().Interface())，避免对着空错误干瞪眼。
事情说清了就结束
