应通过 skip-dirs 排除 vendor/ 和 generated/ 等目录,或用 //nolint:staticcheck,unused 精准抑制生成代码告警;禁用 exclude-rules 或全局 disable 会掩盖真实问题,增加技术债务与运行时风险。

为什么 vendor/ 和 generated/ 里的代码总报 SA1019、unused 等告警
不是你代码写错了,是 golangci-lint 默认会扫描所有 .go 文件——包括 protobuf 生成的 pb.go、Swagger 生成的 doc.go、vendor/ 里第三方库的源码。这些文件本就不该人工修改,但 staticcheck、unused 等 linter 仍会逐行分析,导致大量无效告警(比如 SA1019: Use of deprecated function 在 grpc-go 的生成代码里反复出现)。
用 skip-dirs 彻底跳过生成目录
最干净的做法是在 .golangci.yml 里明确排除,而不是靠注释压制:
-
skip-dirs必须写在run:下级,不是linters-settings:里 - 路径名要加引号,避免 YAML 解析错误:
skip-dirs: ["vendor", "generated", "docs"] - 如果用了
protoc-gen-go,生成目录常叫api/gen或internal/pb,也得加进去 - 注意:跳过目录后,里面任何文件都不会被任何 linter 触及——包括你误放进去的手写代码,所以别偷懒把业务代码塞进
generated/
个别文件无法跳过时,用 //nolint 精准抑制
某些场景下(比如 Swagger doc.go 被放在 ./ 根目录),skip-dirs 失效,只能单文件处理:
- 在文件顶部加
//nolint:staticcheck,unused(逗号分隔多个 linter 名) - 必须写在 package 声明之前,且不能换行:
//nolint:staticcheck有效,//nolint:\nstaticcheck无效 - 不要写
//nolint(不带冒号和 linter 名),这会禁用全部检查,掩盖真实问题 - 生成代码里已有类似
// Code generated by ... DO NOT EDIT.注释?别删它——golangci-lint 不识别这个,只认//nolint
别碰 exclude-rules 和全局 disable
有人想“一劳永逸”地过滤掉所有来自第三方的告警,于是去配 exclude-rules 或全关 unused,结果反而埋雷:
立即学习“go语言免费学习笔记(深入)”;
-
exclude-rules需要正则匹配文件路径,但不同项目生成路径不统一(vendor/github.com/xxxvsthird_party/protobuf),维护成本高 - 全局
disable: ["unused"]会让真正该删的未用函数逃过检查,技术债务越积越多 - 更危险的是,有些 linter(如
errcheck)一旦被 disable,连你自己写的os.Open()都不提醒 error 处理,直接引入 runtime panic 风险
真正关键的点就一个:生成代码的边界必须清晰。要么用 skip-dirs 物理隔离,要么用 //nolint 精确标记——混用或绕过,迟早会在某次 protobuf 升级后突然冒出 200+ 条告警,而你根本不知道哪些是真问题。


















