golangci-lint 应按项目阶段动态配置：新手期启用 govet、errcheck、staticcheck、gofmt、goimports 五项最小可用集；中大型项目逐步增强 errname、wrapcheck、gocyclo 等；生产环境须禁用 golint/deadcode/typecheck 并排除 vendor/pb.go 等生成代码。
你想在Go项目中启用真正有用的静态检查，又不想被大量低价值告警淹没，需要一套经过验证的linter组合策略——不是全开，也不是只开govet，而是根据项目阶段和团队成熟度动态取舍。
新手项目起步：最小可用检查集
刚初始化项目或团队刚接触静态检查时，优先启用基础、稳定、误报率极低的linter，避免一上来就被满屏警告劝退。
第一步：创建 【.golangci.yml】 文件，写入以下内容：
linters-settings:
errcheck:
check-type-assertions: true
check-blank: true
linters:
enable:
- govet
- errcheck
- staticcheck
- gofmt
- goimports
这五个是当前最稳妥的起点。govet捕获语言级陷阱，errcheck强制处理错误返回值，staticcheck覆盖语义级缺陷（如空指针解引用、未使用的变量），gofmt+goimports保障基础格式统一。
注意：【不要启用 golint】 ——它已于2022年归档，规则陈旧且与现代Go版本不兼容，开启后会导致大量过时告警（比如强制要求注释首词必须是函数名）。
中大型项目进阶：按需增强检查维度
当代码基线稳定、CI流程跑通后，可逐步加入更严格的检查器，聚焦可维护性与协作一致性。
方法一：强化错误处理与资源安全
在 linters.enable 列表中追加：
- errname（检查错误变量命名是否以 Err/err 开头）
- wrapcheck（检测 error 是否被合理包装，避免丢失原始上下文）
- nilerr（识别无意义的 nil 错误返回）
方法二：控制代码健康度
加入：
- gocyclo（圈复杂度超过10时告警，防止单函数逻辑爆炸）
- dupl（重复代码片段超50行触发提示）
- gosec（扫描硬编码密码、不安全函数调用等安全风险）
方法三：格式与风格精细化
替换 gofmt → gofumpt（更严格的格式规则，禁用 tab 缩进、强制空格分隔操作符）
启用 revive（比已弃用的 golint 更灵活，支持 TOML 配置，可精准开关 blank-imports/exported 等规则）
生产环境收口：关闭干扰项与排除生成代码
上线前必须清理噪音，否则开发者会习惯性忽略所有告警。
① 在 .golangci.yml 中显式禁用三类高干扰 linter：
linters:
disable:
- golint
- deadcode
- typecheck
② 排除 vendor/、mocks/、pb.go、gen.go 等非人工编写目录和文件：
skip-dirs:
- vendor
- mocks
- internal/generated
exclude-rules:
- path: ".*_test\.go"
linters:
- gosec
- path: ".*pb\.go$"
linters:
- all
③ 设置超时与并发，防止检查卡死：
timeout: 2m
concurrency: 4
这一步做完后，golangci-lint run 就能稳定输出可信、可操作的检查结果。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
