白名单本质是排除误报的组合策略，通过skip-dirs、exclude-rules、//nolint和linter级开关协同实现；exclude-rules需置于根层级、用子串正则匹配告警文本；skip-dirs前缀匹配目录；//nolint仅单点临时压制且不作用于独立工具。
白名单不是配置项，本质是排除误报的组合策略
golangci-lint 没有叫“白名单”的配置字段。所谓“白名单”，实际是通过 skip-dirs、exclude-rules、//nolint 和 linter 级别开关这四种手段协同实现的——目标不是放行某些代码，而是精准压制特定场景下的误报。
用 exclude-rules 精确过滤误报行
当某个 linter 在固定模式下频繁误报（比如 errcheck 对 log.Fatal 报错），用 exclude-rules 比全局关掉更安全：
- 必须写在
.golangci.yml的根层级，不能嵌套在linters-settings里 - 匹配基于正则，且只匹配告警消息文本（不是代码内容），例如：
issues: exclude-rules: - path: ".*\.go$" linters: - errcheck text: "calling .+ with no error check" - 常见误报场景可直接复用：
text: "SA1019: .+Value.+"屏蔽所有Value()警告；text: "S1030: .*should use copy.*"避免对unsafe.Slice类操作误报 - 注意：正则中不要加
^或$——golangci-lint 内部做的是子串匹配，加了反而失效
skip-dirs 和 skip-files 是最稳的“目录级白名单”
对 vendor、生成代码、文档目录这类明确不该 lint 的路径，skip-dirs 是唯一可靠方式：
-
skip-dirs是前缀匹配，写vendor就能跳过vendor/和myapp/vendor/，但不能写./vendor或/vendor - 生成代码目录（如
pb.go、mock_*.go）务必显式加入，否则errcheck会卡在proto.Unmarshal上 -
skip-files支持正则，但只作用于文件名（不含路径），例如：- ".*_test\.go$"可跳过所有测试文件，但无法跳过vendor/foo/bar_test.go——这种仍得靠skip-dirs: [vendor] - 多 module 项目中，每个 module 的
.golangci.yml必须各自声明skip-dirs，根配置不会向下继承
//nolint 只适合单点压制，别当白名单用
//nolint 是临时补丁，不是配置策略。滥用会导致问题蔓延：
立即学习“go语言免费学习笔记（深入）”；
- 必须紧贴代码行末尾，中间不能有空格或换行，写成
// nolint或//nolintlint都无效 - 想忽略多个 linter，用逗号分隔：
//nolint:errcheck,staticcheck，但别写成//nolint:errcheck staticcheck（空格不合法） - 函数级别忽略要放在函数声明行末尾：
func handler() { //nolint，不是函数体第一行 - 绝不能在
import块里加//nolint想绕过未使用包警告——它只对紧邻的变量/函数声明生效，import 行需用_或重构解决
真正容易被忽略的是：//nolint 只在 golangci-lint 运行时生效，直接调 staticcheck 或 go vet 命令时完全无视它。
