golangci-lint 不支持 exclusions 字段,正确排除方式仅有三种:run.skip-dirs(相对路径、不带./)、run.skip-files(全路径正则、双反斜杠转义)和行内 //nolint(紧贴语句末尾、逗号分隔linter)。

golangci-lint 的 exclusions 字段根本不存在
别在配置里写 exclusions——它不是 golangci-lint 支持的合法字段。你看到的文档、报错或 IDE 提示里出现这个词,大概率是混淆了其他工具(比如 SonarQube 或 ESLint)的术语,或是旧版 fork/自定义分支的非标扩展。
官方配置中真正用于“排除”的机制只有三类:run.skip-dirs、run.skip-files 和行内 //nolint。试图用 exclusions 会导致整个配置段被 YAML 解析器忽略,且无任何警告。
run.skip-dirs 怎么写才不踩坑
这是最常用也最容易出错的排除方式,尤其在 vendor 处理上。
- 路径必须相对于
.golangci.yml所在目录,不能带前缀./或src/;写成- ./vendor就失效 - 空数组
skip-dirs: []会覆盖默认行为,导致vendor/被重新扫描——默认跳过只在未显式设置该字段时生效 - 多 module 项目中,父目录的
skip-dirs不会继承到子 module;每个 module 目录下都得有自己的一份.golangci.yml - 推荐写法:
run: skip-dirs: [vendor, testdata, docs, internal/testutil],显式声明比依赖默认更可靠
run.skip-files 支持正则但限制多
它用的是 Go 的 regexp 包,但匹配对象是**完整文件路径(从配置文件所在目录起算)**,不是文件名。
立即学习“go语言免费学习笔记(深入)”;
- 正确示例:
- ".*_test\.go$"可跳过所有测试文件;注意双反斜杠转义 - 错误写法:
- "_test.go"(没加锚点和转义,会误匹配my_test.go.bak) - 路径含目录时必须写全:
- "cmd/myapp/main\.go",不能只写"main\.go" - 不支持 glob 语法(如
**/*.go),也不支持负向匹配
单行忽略只能靠 //nolint,不是 //nolintlint
这是唯一能作用于具体代码行的排除方式,但规则很硬:
- 必须紧贴语句末尾,中间不能换行、不能有其他注释隔开:
var x = 1 //nolint✅,var x = 1 // nolint❌(空格) - 指定 linter 时用逗号分隔:
//nolint:goconst,unused,不能写成//nolint goconst - 对
import块无效;未使用包得用_别名或重构解决 - 只在
golangci-lint run下生效;直接跑staticcheck或govet命令时完全无视
复杂点在于:skip-dirs 是项目级策略,skip-files 是路径级过滤,//nolint 是代码级逃生舱——三者粒度不同,不能互相替代,也别指望一个配置字段搞定所有排除需求。


















