直接启用 unused linter 即可检查未使用的变量、函数、类型和导入包,但必须确保它没被禁用、配置文件生效、且不被 skip-files 或 skip-dirs 误排除。

直接启用 unused linter 即可检查未使用的变量、函数、类型和导入包,但必须确保它没被禁用、配置文件生效、且不被 skip-files 或 skip-dirs 误排除。
为什么 unused 默认不工作
golangci-lint 安装后默认只启用 govet 和 errcheck,unused 属于“需显式开启”的关键 linter。如果你没在 .golangci.yml 中启用它,或配置文件根本没被读取,那它就完全不会运行。
-
unused不是 govet 的子功能,它独立实现,不依赖govet配置 - 多 module 项目中,每个 module 目录下都得有自己的一份
.golangci.yml,根目录的配置对子 module 无效 - CI 或终端里只写
golangci-lint run而不加--config=.golangci.yml,等于没用上你的配置 -
skip-files: [".*_test\.go"]这类正则会同时屏蔽main_test.go和util_test.go,但也会让unused漏掉测试文件里的未使用变量(比如var tt testCase)
怎么正确启用 unused
在项目根目录(与 go.mod 同级)放一个 .golangci.yml,内容至少包含:
linters:
enable:
- unused
run:
skip-dirs:
- vendor
- testdata
- docs- 不要写
enable-all: true然后靠disable列表去筛——容易漏掉或误禁 -
skip-dirs显式声明比依赖默认行为更可靠,尤其当配置里出现disable-all: true时,默认跳过vendor会失效 - 如果想检查测试文件中的未使用变量(如
var benchTest func()),确认skip-files没包含_test.go,且没清空run块导致覆盖默认逻辑
unused 会报哪些典型问题
它主要识别编译器无法捕获但实际无意义的声明,比如:
立即学习“go语言免费学习笔记(深入)”;
- 未被引用的局部变量:
var x int后面没再用过 - 只赋值不读取的结构体字段:
s := struct{ f int }{f: 42},但s.f永远没被访问 - 未导出的全局变量/函数/常量:比如
var helperVal = "x"在整个包内都没被调用 - 未使用的 import(注意:它不处理
_ "net/http/pprof"这类副作用导入,那是goimports或revive的职责)
它不会报 import "fmt" 但只用了 fmt.Println 这种“部分使用”——那是 goimports 的范围。
常见误报和收敛建议
unused 本身误报率很低,但以下情况容易触发“假阳性”:
- benchmark 函数名以
Benchmark开头但没被go test -bench调用 → 确认是否真废弃,否则加//nolint:unused - 测试文件中
var tests = []struct{...}被标记为未使用 → 实际是用于for _, tt := range tests,这是已知局限,可关掉该文件检查或改用require包的 table-driven 写法 - interface 实现方法被标记未使用 → 检查是否漏了
type MyImpl struct{}的指针接收器定义,或是否在go list时没包含该包 - 与
staticcheck同时启用时,对未使用 error 变量的判断可能重叠(staticcheck报 SA4006,unused报变量未用),建议保留unused,关闭staticcheck的相关子规则
真正难收敛的不是 unused 本身,而是你代码里那些“看起来没用、其实被反射或 plugin 加载”的标识符——这类必须手动 //nolint:unused,别指望自动识别。


















