golangci-lint 默认跳过 vendor 但极易失效,主因是配置覆盖默认行为:如 run.skip-dirs: [] 清空默认、disable-all: true 未补 skip-dirs、路径写错或嵌套 vendor 漏配;应显式声明纯目录名 vendor 等于 skip-dirs。

golangci-lint 默认跳过 vendor 目录,但这个“默认”非常脆弱——只要配置里动了一行,就可能失效。
为什么 vendor 还是被扫描了?常见配置踩坑点
不是 golangci-lint 忘了跳过 vendor,而是你的 .golangci.yml 无意中覆盖了默认行为:
- 写了
run.skip-dirs: [](空数组):这会完全清空默认值,vendor立刻进入扫描范围 - 启用了
disable-all: true却没补run.skip-dirs块:默认跳过逻辑不触发,vendor 被全量分析 - 路径写成
./vendor或/vendor:前者是冗余相对路径,后者被当作绝对路径解析失败,均无法匹配 - 项目结构含嵌套 vendor(如
api/vendor),但配置只写了third_party:漏掉实际存在的目录
最稳妥的显式声明方式
别赌“默认”,直接在 .golangci.yml 根层级写死:
run:
skip-dirs:
- vendor
- testdata
- docs
- third_party
- deps
注意:
-
vendor是前缀匹配,能同时跳过vendor/和myapp/vendor/ - 所有路径必须是相对于配置文件所在目录的**纯目录名**,不加
./,也不加斜杠结尾 - 多 module 项目中,每个 module 的
.golangci.yml都要单独配,不能共用根配置
命令行临时跳过 vs 配置文件永久跳过
用 go list + grep 过滤(如 golangci-lint run $(go list ./ | grep -v '/vendor/'))看似灵活,但有硬伤:
- 无法排除
vendor/foo/bar_test.go这类测试文件,而skip-dirs是整目录屏蔽 - 若包名真含
vendor字样(如myvendorutil),grep -v会误杀 - 每次执行都重新
go list,绕过 golangci-lint 的增量缓存,CI 中反复变慢
真正容易被忽略的是:即使你确认 vendor 没被扫描,也要检查 go.mod 是否在当前目录——如果 golangci-lint run 在子目录执行,它连 vendor 存不存在都不知道,直接报 no go files to analyze。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











