go vet 和 staticcheck 是互补工具：前者是官方轻量级检查器，捕获语言层面常见错误；后者是社区增强型分析器，覆盖逻辑缺陷和风格问题。
go vet 和 staticcheck 不是互斥工具，而是互补关系：前者是 Go 官方内置的轻量级检查器，能捕获语言层面常见错误；后者是社区主流的增强型静态分析器，覆盖更多逻辑缺陷和风格问题。单独用 go vet 会漏掉大量潜在 bug，只用 staticcheck 则可能忽略一些编译器已知但未触发的底层误用。
什么时候该运行 go vet？
go vet 是构建流水线中必须执行的基础检查，它不依赖外部安装，开箱即用，且运行极快。但它只检查 Go 标准库约定下的典型误用，比如格式化动词与参数类型不匹配、无用的变量赋值、重复的 case 值等。
- 在
go build或go test前自动运行：go vet ./...（注意路径末尾的...表示递归扫描所有子包） - 不建议对单个文件运行（如
go vet main.go），因为很多检查依赖包级上下文，例如接口实现验证 - 某些检查默认关闭，需显式启用：例如
go vet -printfuncs=Infof,Warnf,Errorf ./...才能识别自定义日志函数中的格式化错误 - CI 中应使用
GOOS=linux go vet ./...避免因本地GOOS不同导致平台相关检查被跳过
staticcheck 能查到哪些 go vet 没覆盖的问题？
staticcheck 的核心价值在于发现语义级隐患，比如空指针解引用风险、错误的并发模式、未使用的 struct 字段、过度复杂的条件表达式。它不是 Go 官方工具，需手动安装：go install honnef.co/go/tools/cmd/staticcheck@latest。
- 典型误报少，但对泛型代码支持仍弱于
go vet；遇到泛型报错先确认是否为已知 issue（如SA1019在泛型方法调用中误标弃用） - 默认不检查测试文件，加
-tests参数才启用（如staticcheck -tests ./...） - 可配合
.staticcheck.conf禁用特定检查项，例如禁用ST1005（错误消息首字母大写）以适配团队习惯 - 与
golangci-lint共存时，要关掉它的govet和staticcheck子检查器，否则重复告警且配置冲突
如何让两者在 CI 中协同工作？
关键不是并行跑两个命令，而是分层拦截：go vet 作为“快速失败”环节，staticcheck 作为深度扫描环节。两者输出都应设为非零退出码，任何警告即中断构建。
- 推荐 shell 脚本顺序执行：
go vet ./... || exit 1<br>staticcheck ./... || exit 1
- 避免用
&&连接，否则go vet出错时staticcheck不会运行，掩盖更深层问题 - 在 GitHub Actions 中，把两者的输出重定向到
stderr并添加error:前缀，能让 Actions 自动高亮定位错误行 - 若项目含 cgo，
staticcheck可能卡住或报错，此时应在staticcheck命令后加--fail-on-issues=false并人工复核，而不是直接跳过
真正难的是判断一个 staticcheck 报告是否该修复——有些是过度严格（如 SA9003 警告空 select），有些却是真实隐患（如 SA1017 检测 time.After 在循环中滥用）。这类边界情况没有通用规则，只能结合上下文逐条读文档确认。
