golangci-lint 默认仅启用 govet 基础子集，需在 .golangci.yml 中显式配置 linters-settings.govet.enable 启用 printf、tests、shadow 等关键子检查项，否则会漏检类型不匹配、测试逻辑错误、变量遮蔽等隐患。
golangci-lint 默认已启用 govet，但仅靠默认配置无法发现多数真实隐患——govet 的深度检查项（如 printf、atomic、tests）需显式开启，否则会漏掉类型不匹配、竞态误用、测试逻辑错误等关键问题。
govet 在 golangci-lint 中不是“全开”状态
很多人以为 golangci-lint run 就等于跑全量 go vet，其实不然。golangci-lint 默认只启用 govet 的基础子集（如 assign、atomic 等少数几个），大量高价值检查项被关着：
-
printf：检测fmt.Printf参数类型与动词不匹配（比如用%d打印string） -
tests：识别测试函数中未调用t.Fatal/t.Error却返回错误的常见反模式 -
shadow：发现变量遮蔽（同名局部变量覆盖外层变量，导致逻辑异常） -
structtag：校验 struct tag 语法合法性（如json:"name,string"中string是否被正确支持）
这些必须在 .golangci.yml 中手动加进 govet 的 settings 里，否则不会触发。
如何正确启用 govet 的关键子检查项
在项目根目录的 .golangci.yml 中，明确声明需要的 govet 子检查项：
linters-settings:
govet:
enable:
- printf
- tests
- shadow
- structtag
- atomic
- copylocks
- fieldalignment
注意：enable 是白名单模式，没列出来的就不会运行；不要写 disable 来“关掉默认项”，那反而容易误关关键项。
另外，fieldalignment 对性能敏感服务很重要——它能提示结构体字段排列导致的内存浪费，但默认关闭，且只在 GOARCH=amd64 下生效。
常见误报与合理豁免方式
启用 tests 后，mock 测试里常报 call to t.Errorf from a non-test function；启用 shadow 后，for-range 循环中重用 err 变量也会告警。这不是 bug，是 govet 保守策略：
- 对测试文件统一豁免：
run: --skip-dirs="testdata|_test"（避免 mock 场景误报） - 对特定目录或文件忽略：
exclude-rules中加一条针对shadow的路径规则 - 不建议全局禁用
shadow——它确实能揪出不少真实作用域混淆问题
还有个细节：govet 的 printf 检查依赖 go/types 类型信息，如果项目用了 //go:build 多构建约束但没配 build-tags，可能漏检；此时需在配置里补上：build-tags: ["unit", "integration"]（按实际 tag 填）。
CI 中让 govet 报错真正中断流程
本地 golangci-lint run 默认只输出警告，CI 里必须强制失败：
- 加
--issues-exit-code=1：只要有任何 issue（包括 govet 的 warning），就返回非零码 - 避免
--fast跳过缓存时意外跳过 govet——govet不依赖缓存，但--fast可能绕过部分分析阶段，建议 CI 中去掉该 flag - 若用 GitHub Actions，搭配
--out-format=github-actions，能让问题直接标在 PR 行号上
最关键的是：别把 govet 当成“锦上添花”，它是 Go 官方背书的语义守门员，很多 panic 或逻辑错位，在编译期和测试期都难暴露，全靠它提前卡住。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
