用 validator 而不是手写 if 校验，因其通过 struct tag 声明规则、自动遍历聚合错误、适配 Gin/Echo 绑定流程，避免手写校验的重复、难复用、难测试及边界遗漏问题。
为什么用 validator 而不是手写 if 校验？
因为微服务接口多、参数嵌套深、校验规则重复——手写 if 会快速失控：字段空值判断、长度限制、正则匹配、结构体嵌套校验都要自己递归处理，且无法复用、难测试、易漏边界。而 validator（指 go-playground/validator/v10）通过 struct tag 声明规则，自动遍历字段并聚合错误，天然适配 Gin、Echo 等框架的绑定流程。
注意：它不校验业务逻辑（比如“用户余额是否足够”），只做数据格式与约束合规性检查；业务级校验仍需在 handler 或 service 层手动写。
如何让 gin.Context.Bind() 自动触发 validator 校验？
Gin 默认使用 go-playground/validator/v10 作为其绑定器后端，但前提是：你必须提前注册自定义 validator 实例，并确保 struct tag 写法正确。否则 Bind 会静默跳过校验，只做类型转换。
- 在
main.go初始化时调用gin.SetMode(gin.ReleaseMode)后，立即设置：v := validator.New()<br>v.RegisterValidation("mobile", validateMobile)<br>gin.Validator = v - struct tag 必须用
validate键，例如：type CreateUserReq struct {<br> Name string `json:"name" validate:"required,min=2,max=20"`<br> Phone string `json:"phone" validate:"required,mobile"`<br>} - 调用
c.ShouldBind(&req)或c.Bind(&req)才会触发校验；c.ShouldBindJSON()也行，但底层仍是ShouldBind。 - 别用
c.GetPostForm+ 手动赋值——那样绕过了 validator，等于白配。
怎么统一返回校验失败的错误格式？
默认错误是 validator.ValidationErrors 类型，直接 c.JSON(400, err) 会暴露内部字段名和 tag 名，前端难解析，也不符合公司错误码规范。
立即学习“go语言免费学习笔记（深入）”；
- 拦截
err类型，转成标准错误响应：if err != nil {<br> if errs, ok := err.(validator.ValidationErrors); ok {<br> c.JSON(400, map[string]interface{}{<br> "code": 40001,<br> "msg": "参数校验失败",<br> "data": translateErrors(errs), // 自定义翻译函数<br> })<br> return<br> }<br>} -
translateErrors里用errs.Translate(trans)配合ut.New加载中文翻译，避免硬编码字段名；字段名建议用Field而非StructField，更贴近 JSON key。 - 不要把整个
ValidationErrors直接序列化返回——它包含Namespace、Param等调试字段，敏感且冗余。
嵌套结构体、slice 和指针字段怎么写 tag？
嵌套校验最容易漏掉 dive 和 omitempty，导致空 slice 不校验、nil 指针 panic、深层字段被跳过。
- 对 slice 元素校验加
dive：Tags []string `json:"tags" validate:"required,dive,min=1,max=50"`
否则只校验 slice 本身是否为 nil 或空，不进元素。 - 对嵌套 struct 字段，tag 中必须显式加
required或其他规则，否则默认不校验其内部字段：User *UserInfo `json:"user" validate:"required"`<br>type UserInfo struct {<br> Email string `json:"email" validate:"required,email"`<br>} - 指针字段（如
*string）若允许为空，用omitempty；若不允许为空，必须同时写required和具体规则：Name *string `json:"name" validate:"required,min=1"`
否则nil会被当成空字符串跳过min校验。
深层嵌套时，validator 不会自动递归展开未声明 validate tag 的 struct 字段——它只认你明确标记的地方。
