必须手动初始化 validator.new()，否则 validate.struct() 会 panic: nil pointer；常见错误是声明了变量但未在 init() 中赋值，或遗漏 import _ "your-project/validator" 触发初始化。
必须手动初始化 validator.New()，否则调用 Validate.Struct() 会 panic: nil pointer
为什么 GoLand 里一跑就 panic: nil pointer？
不是 GoLand 的问题，也不是库坏了——90% 是因为你在代码里写了 validate.Struct(req)，但压根没创建过 validator.Validate 实例。GoLand 只是忠实地执行了你的代码，而 validate 是个未初始化的 nil 指针。
常见错误写法：
-
var validate *validator.Validate声明了变量，但没在init()或包初始化时赋值 - 在 handler 里每次请求都
validator.New()，然后传给局部变量，但全局validate仍是 nil - 复制了示例代码，却漏掉了
func init() { validate = validator.New() }这一行
GoLand 中正确引入和初始化步骤
打开项目后，别急着写校验逻辑，先做三件事：
- 执行
go get github.com/go-playground/validator/v10（在 GoLand 终端里敲，或用右上角 Terminal 面板） - 在项目根目录下新建
validator/validator.go（或放在internal/pkg/validator），内容为：package validator import "github.com/go-playground/validator/v10" var Validate *validator.Validate func init() { Validate = validator.New() } - 在 main.go 或启动文件里 import 这个包（哪怕不直接用，确保
init()被触发）：import _ "your-project/validator"
之后所有地方都用 validator.Validate.Struct(req)，而不是自己 new。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
结构体 tag 写错导致“校验像没开”
GoLand 不会高亮 tag 错误，但校验完全静默失效——你改了字段、加了 required，提交空数据却没报错。原因几乎全是 tag key 写错：
-
validation:"required"❌ —— 库只认validate这个 key -
validate:required❌ —— 缺少双引号，解析失败，直接跳过 -
validate:"required, min=2"❌ —— 逗号后带空格，v10 默认 strict mode 下会忽略整个 tag -
name string `validate:"required"`❌ —— 字段小写，反射读不到，不校验也不报错
正确写法只有这一种：Name string `json:"name" validate:"required,min=2,max=20"`
嵌套结构体或切片校验不递归？
比如 Addr Address 或 Tags []string，字段本身校验通过了，但 Addr.City 为空、Tags 里有空字符串——这说明你漏了 dive。
-
Addr Address `validate:"required,dive"`✅ —— 结构体嵌套需显式加dive -
Tags []string `validate:"required,dive,min=1"`✅ —— 切片内每个元素执行min=1 -
Meta map[string]string `validate:"dive,keys,alphanum,endkeys,required"`✅ —— map 的 key 和 value 分别校验 -
Child *Child字段为 nil 时，dive自动跳过，这是预期行为，不用额外判空
最容易被忽略的是：嵌套结构体字段名必须导出（大写），且内部字段也要带 validate tag，否则 dive 进去也白进。
