应使用 go-playground/validator 库，它支持标签驱动、嵌套校验和自定义规则，且无运行时依赖；避免使用已归档的 asaskevich/govalidator。
结构体字段验证该用哪个库
Go 标准库不提供字段级验证，encoding/json 和 reflect 仅支持基础序列化与反射，不做校验。生产项目普遍用 go-playground/validator，它支持标签驱动、嵌套结构、自定义规则，且无运行时依赖。别用 asaskevich/govalidator —— 已归档，不维护，Validate 方法在 Go 1.21+ 下有 panic 风险。
validator 标签怎么写才不出错
标签必须写在 struct 字段后、反引号内，且不能拼错字段名或参数。常见错误是把 required 写成 require，或漏掉 json 标签导致反序列化后字段为空但验证跳过。
type User struct {
ID int `json:"id" validate:"required,gt=0"`
Name string `json:"name" validate:"required,min=2,max=20"`
Email string `json:"email" validate:"required,email"`
Age uint8 `json:"age" validate:"gte=0,lte=150"`
}
-
required只检查零值（""、0、nil），对指针字段要加omitempty或用required_if -
email不校验 DNS 或 MX 记录，只做格式正则匹配 - 嵌套结构需在字段上加
validate:"required"，并在类型定义里也加 validator 标签，否则Struct不递归校验
验证失败后怎么拿具体字段和错误
直接调 Validate.Struct() 返回 error，但它是封装过的 validator.ValidationErrors 类型，不能用 fmt.Errorf 直接打印字段名。必须类型断言并遍历：
err := validate.Struct(user)
if err != nil {
if errs, ok := err.(validator.ValidationErrors); ok {
for _, e := range errs {
fmt.Printf("field: %s, tag: %s, value: %v\n", e.Field(), e.Tag(), e.Value())
}
}
}
-
e.Field()返回结构体字段名（如"Name"），不是 JSON key（"name"） -
e.Param()可取min、max等参数值，用于动态提示 - 若需返回 HTTP 错误，建议映射为 map[string]string：键用
e.StructNamespace()提取路径（如"User.Email"），避免前端无法定位嵌套字段
自定义验证函数怎么注册和触发
比如限制手机号必须是大陆 11 位数字，不能只靠正则标签——得注册函数，并在 tag 中引用函数名：
立即学习“go语言免费学习笔记（深入）”；
validate.RegisterValidation("chinese_mobile", func(fl validator.FieldLevel) bool {
s := fl.Field().String()
return regexp.MustCompile(`^1[3-9]\d{9}$`).MatchString(s)
})
// 使用
type User struct {
Mobile string `validate:"chinese_mobile"`
}
- 函数名必须全小写，tag 中也写小写，否则注册无效
-
fl.Field()返回reflect.Value，对指针字段要先fl.Field().Elem() - 不要在验证函数里 panic，validator 不 recover；出错应返回
false，错误信息靠RegisterTranslation补充
最易被忽略的是：validator 默认不校验 nil 指针字段，哪怕你写了 required。如果字段是 *string，必须显式加 nonnil 标签，或改用 required_with 组合逻辑。
