gin 默认不支持多语校验，需手动注册中文翻译器：获取 binding.validator.engine() 中的 validator 实例，创建 zh.translator，调用 zh.registerdefaulttranslations 绑定，且必须在 gin.default() 后、路由前执行。
直接上结论：Gin 默认不带多语校验能力，必须手动注册 zh 翻译器并绑定到全局 validator 实例，否则 c.ShouldBindJSON 返回的永远是英文错误（如 Field validation for 'Username' failed on the 'required' tag）。
为什么 validator.Error() 一直是英文
因为 Gin 内部使用的 *validator.Validate 实例默认没有加载任何翻译器。即使你 import 了 github.com/go-playground/validator/v10/translations/zh，不显式调用 RegisterDefaultTranslations，它就只是个没被激活的包。
-
binding.Validator.Engine()返回的是 Gin 封装后的 validator 实例，不是新创建的 —— 必须从它取出来再注册翻译 - 翻译器（
ut.Translator）和 validator 实例必须一对一绑定，不能复用多个 locale 的 translator 到同一个 validator - 注册动作只能在应用启动时做一次，重复调用
RegisterDefaultTranslations会 panic
如何正确注册中文翻译器
核心是三步：获取 validator 引擎 → 创建中文 translator → 绑定并注册默认翻译。别漏掉 switch locale 分支，否则 zh 不生效。
import (
"github.com/gin-gonic/gin/binding"
"github.com/go-playground/validator/v10"
"github.com/go-playground/validator/v10/translations/zh"
"github.com/go-playground/locales/zh"
"github.com/go-playground/universal-translator"
)
func InitZhTrans() error {
v, ok := binding.Validator.Engine().(*validator.Validate)
if !ok {
return fmt.Errorf("invalid validator engine")
}
zhLocale := zh.New()
uni := ut.New(zhLocale)
trans, _ := uni.GetTranslator("zh")
return zh.RegisterDefaultTranslations(v, trans)
}
- 必须在
gin.Default()或gin.New()之后、路由注册之前调用InitZhTrans() - 不要在 handler 里调用它，否则每次请求都尝试注册，必然 panic
- 如果项目要支持中英文切换，需额外保存
trans到 context 或全局变量，再按请求 header 动态选 translator
怎么让错误信息显示“用户名”而不是“Username”
字段名翻译靠结构体 tag 中的 label，不是靠反射名。validator 本身不读 label，得自己写逻辑提取。
- 原始错误
err是validator.ValidationErrors类型，遍历每个FieldError可拿到Field()（即结构体字段名） - 用
reflect.TypeOf(&v).Elem().FieldByName(field)查labeltag，例如：Username string `json:"username" binding:"required" label:"用户名"` - 若没写
label，fallback 到Translate方法用 translator 翻译字段名（需提前注册字段名映射，比如registerTranslation("Username", "用户名")）
常见踩坑点
最常被忽略的是「绑定方式」和「tag 匹配」不一致导致校验静默失效——错误根本没触发，你还以为翻译没起作用。
- 用
c.ShouldBindJSON但结构体 tag 是form:"xxx"→ 字段压根不赋值，binding:"required"形同虚设 - 前端传 JSON，但后端结构体漏写
json:"xxx"→ 解析失败，validator 拿到空字符串，min=6校验通过（因空字符串长度为 0，不满足min但required会报错；但如果字段类型是 int 且没传，可能 fallback 成 0，gte=1就挂了） - GET 请求用
c.ShouldBindJSON→ 解析失败返回invalid character错误，不是 validator 错误，翻译器完全没机会介入 - 自定义校验函数注册时用了
v.RegisterValidation，但没在InitZhTrans之后注册 → 翻译器不知道这个新规则，错误信息仍是英文模板
多语校验真正难的不是注册那几行代码，而是确保整个链路——从请求解析、结构体绑定、validator 执行、到错误组装——全部对齐。任何一个环节断开，你看到的就只是“翻译没生效”，实际可能是校验根本没跑起来。
