go vet默认仅启用少量检查项,需手动启用如-unmarshal、-copylocks等关键选项;golangci-lint中须在linters-settings.govet下配置enable或enable-all,且enable与disable不可共存。

govet 默认不启用全部子检查项,必须显式控制
go vet 本身是一组子检查器的集合(如 atomic、printf、shadow、structtag),但 golangci-lint 默认只启用其中一部分。它不会自动打开所有 govet 子项,也不会继承 go vet -vettool=... 的行为。你看到的 “没报 structtag 错误” 或 “没发现 shadow 变量覆盖”,大概率不是代码没问题,而是对应子检查根本没开。
在 .golangci.yml 中用 linters-settings.govet 控制
必须把配置写在顶层 linters-settings 下,不是 linters 或嵌套在其他字段里。常见有效写法包括:
-
linters-settings:→govet:→enable-all: true(一键全开,适合新项目) -
linters-settings:→govet:→disable:→- "fieldalignment"(关掉已知干扰项) -
linters-settings:→govet:→enable:→- "printf"→- "structtag"(精准启用,推荐)
注意:enable 和 disable 不能共存;若同时出现,disable 会覆盖 enable。另外,fieldalignment 在 Go 1.21+ 中常误报结构体对齐建议,多数服务端项目可安全禁用。
验证 govet 子项是否真生效了
光看配置文件存在不等于生效。运行时加 -v 参数能确认实际加载了哪些子项:
golangci-lint run -v | grep -A5 "govet"
输出中应包含类似 govet: printf, structtag, shadow 的列表。如果只显示 govet 而无子项名,说明配置路径错误或缩进失效(YAML 必须用空格,Tab 会导致解析失败)。另一个快速验证方式是故意写一个 structtag 错误:
type User struct {
Name string `json"name"` // 少了个 =
}
若没报错,基本可断定 structtag 子检查未启用。
别和 go tool vet 混用,行为不一致
golangci-lint 内部调用的是封装后的 govet,不是直接执行 go vet 命令。因此:
-
go vet -tags=xxx的构建标签控制,golangci-lint不识别——得靠run.build-tags配置 -
go vet -printfuncs=MyLogf这类自定义函数声明,需写进linters-settings.govet.printfuncs - 某些子项(如
copylocks)在golangci-lintv1.54+ 才默认支持,旧版本即使enable-all: true也无效
最易被忽略的是:govet 子项的启用状态完全独立于 staticcheck 或 errcheck,哪怕它们都报“未处理 error”,根源可能一个来自 govet 的 errorsas,另一个来自 errcheck,修复方式完全不同。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











