validator的oneof标签仅支持字符串字段，需写死枚举值且空格分隔、大小写敏感；int等非字符串类型须用自定义验证函数注册实现。
validator怎么校验字符串枚举值
Go 的 validator 库本身不原生支持类似 protobuf 的 oneof 枚举约束，但可以用 oneof 标签实现等效效果——前提是字段是字符串类型，且枚举值全部写死在标签里。
常见错误是直接对 int 类型字段用 oneof，结果校验永远失败：因为 oneof 只比对字符串字面量，不会自动把 int 转成字符串去匹配。
- 只适用于
string字段；int、enum自定义类型需额外处理 - 枚举值之间用空格分隔，不能用逗号或引号：
validate:"oneof=active inactive pending"✅，validate:"oneof='active','inactive'"❌ - 空格敏感：末尾多一个空格会导致最后一个值失效
- 大小写严格匹配，
Active和active视为不同值
非字符串字段（比如 int 枚举）怎么校验
如果用 int 表示状态（如 type Status int; const Active Status = 1），oneof 标签完全无效。必须换思路：自定义验证函数 + validate.RegisterValidation。
本质是绕过字符串比对，改用数值范围或白名单 map 判断。性能影响极小，但要手动注册一次，否则 panic 报 validation function not found。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 先定义验证函数，参数是
*validator.FieldLevel，返回bool - 用
validate.RegisterValidation("status", yourFunc)注册，名字要和 struct tag 里一致 - struct 中使用
validate:"status"，不是oneof - 别忘了在 main 或 init 里调用注册逻辑，否则运行时才报错
为什么 validator.OneOf 不生效的三个高频原因
很多人写了 oneof=... 却没反应，不是库有问题，而是踩中了底层机制盲区。
-
omitempty和oneof共存时：字段为空值（""、0、nil）会直接跳过oneof校验，哪怕你希望空字符串也报错——得去掉omitempty或加required - 嵌套结构体未导出字段：
validator只检查首字母大写的导出字段，小写字段无论 tag 写得多全都忽略 - 指针字段未解引用：字段是
*string且为 nil 时，oneof不会解引用校验，结果是“跳过”，不是“失败”——要加required或改用非指针
想复用枚举定义？别硬编码在 tag 里
把枚举值写死在 struct tag 里，后期增删值要全局搜索修改，极易漏掉。更稳的方式是用常量 + 自定义验证函数，把白名单收口到一处。
比如定义 var validStatuses = map[string]bool{"active": true, "inactive": true}，验证函数里查 map；后续加新状态只改这一处，所有用到的地方自动生效。
- 避免在多个 struct 里重复写
oneof=...，维护成本指数上升 - map 查找比字符串 split+遍历快，尤其枚举项 >5 个时差异明显
- 如果枚举值来自配置或数据库，自定义函数还能动态加载，
oneof标签完全做不到
最麻烦的其实是跨包共享验证逻辑——注册函数必须在 validator 实例初始化前执行，而不同包 init 顺序不确定。真遇到这情况，不如把验证逻辑封装成独立方法，显式调用，别依赖 tag 自动触发。
