go vet 能发现 Printf 格式不匹配、range 循环变量地址复用、未导出字段被 JSON 标签标记、调用弃用函数、指针接收者误用等问题，需用 go vet ./... 全量检查，不可单文件运行。
go vet 不是编译器，也不会报错阻止构建，但它能发现大量真实存在的、容易被忽略的逻辑和用法问题——比如 Printf 格式串和参数不匹配、结构体字段未导出却被 JSON 解析、range 循环中错误复用变量地址。它不是可选项，是上线前必须跑的一环。
哪些问题 go vet 能直接揪出来
它专盯 Go 语言特有的“看起来能跑，其实有坑”的写法：
-
fmt.Printf的格式动词（%s、%d）和传入参数类型不一致，比如fmt.Printf("%d", "hello") - 在
for range中把循环变量取地址存到切片或 map，结果所有元素都指向最后一个迭代值（经典闭包陷阱） - 结构体字段名首字母小写（未导出），但被标记了
json:"xxx"或xml:"xxx"，导致序列化始终为空 - 调用了已弃用的函数或方法（如
time.Time.UTC()在较新版本中标记为 deprecated） - 方法接收者类型和调用方不一致（比如指针接收者方法被值类型调用，且该值不可寻址）
怎么运行才真正起作用
默认只检查当前目录下可编译的 .go 文件，容易漏掉子包或测试文件。实际使用必须加参数：
- 检查整个模块（含所有依赖子包）：
go vet ./... - 同时检查测试文件（
*_test.go）：go vet -tests ./... - 启用全部实验性检查项（Go 1.20+）：
go vet -all ./...（注意：部分检查可能误报，上线前建议单独验证） - 只关注某类问题，比如只查 printf 类型不匹配：
go vet -printf ./...
别用 go vet main.go 这种单文件模式——它看不到跨文件的类型定义和方法调用上下文，很多问题根本检不出。
立即学习“go语言免费学习笔记（深入）”；
常见误报和绕过方式
go vet 的某些检查比较保守，尤其涉及反射、代码生成或动态字段访问时：
- 误报 “struct field tag not compatible with reflect.StructTag”：常见于自定义序列化库或用
unsafe操作 struct tag，可用//go:novet注释跳过该行（仅限明确知道风险时） - 误报 “loop variable captured by func literal”：当确实需要捕获循环变量且已通过显式副本规避（如
val := val; go func() { ... }()），可加//nolint:vet（注意：不是所有 linter 都认这个，需确认你用的go vet版本支持） - CI 中想让
go vet失败即中断，但又不想被误报卡住：先用go vet -json ./...输出结构化结果，再用脚本过滤掉已知误报规则
最常被忽略的是：它不检查未被 import 的包里的问题，也不分析运行时行为（比如空指针解引用）。真正安全的代码，得靠 go vet + 单元测试 + staticcheck（补足更多语义检查）三者配合——少一个，就可能在生产环境突然崩掉。
