golangci-lint是专为Go项目设计的静态检查聚合工具，可并行调度staticcheck、govet、errcheck等十多个检查器，提前发现空循环、未处理错误、弃用API、泛型约束命名违规等隐患。
你需要在Go项目中提前发现空循环、未处理错误、弃用API调用、泛型约束命名违规等隐患，而不是等CI报错或线上出问题才去排查——golangci-lint就是专为这件事设计的静态检查聚合工具，它不是单个linter，而是能并行调度staticcheck、govet、errcheck等十多个检查器的统一入口。
为什么不能继续用golint
golint早在2022年已被Go团队官方归档，仓库只读、无更新、不兼容Go 1.21+泛型深度分析。
它根本不会检查type T[U any]这类泛型声明的命名或约束问题。
默认只查命名和注释风格，对time.Now().Unix() > 0这种恒真判断、for range里滥用time.After、未关闭io.ReadCloser等关键缺陷完全无感知。
立即学习“go语言免费学习笔记（深入）”；
【golint的输出无法自动修复，也不能和go fmt或goimports协同工作】
VS Code、GoLand等主流IDE已默认弃用其集成，改用golangci-lint或revive。
安装golangci-lint的正确方式
官方明确不推荐go get安装，因二进制分发更稳定、版本可控、避免模块污染。
macOS用户直接运行：brew install golangci-lint → brew upgrade golangci-lint。
Linux/Windows用户执行：
curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.57.2
安装后验证：golangci-lint --version，输出应含v1.57.2字样。
【必须确认$(go env GOPATH)/bin在PATH环境变量中，否则终端无法识别命令】
配置文件三要素：位置、命名、缩进
golangci-lint run安静退出但CI爆红？先核对这三项：
① 配置文件名必须是.golangci.yml（不是.golangci.yaml，也不是golangci.yml）；
② 文件必须放在go.mod所在目录（monorepo中每个module各自一份，不是Git根目录）；
③ 全文件缩进只能用空格，严禁Tab；linters-settings和run是顶层字段，不是linters的子项。
CI脚本中别依赖自动发现，显式传参：golangci-lint run --config=.golangci.yml。
启用真正有用的linter
默认只启用约10个基础linter（如govet、errcheck），像staticcheck这种能捕获恒真判断、类型误用、资源泄漏的检查器，默认是关闭的。
方法一：在.golangci.yml中显式启用staticcheck：
linters-settings: staticcheck: enable-all: true
方法二：精简启用关键项：
linters: enable: - staticcheck - goconst - gosimple
同时禁用过时linter：disable: ["golint", "maligned", "scopelint"]。
避免配置反噬项目的实操设置
新手项目直接启用unused或deadcode会刷屏报未导出但未调用的函数，掩盖真正的SA1019（弃用API）或SA1021（time.After滥用）问题。
先禁用高噪声linter：disable: ["unused", "deadcode", "structcheck"]，等代码规模上来再逐步放开。
必须加skip-dirs: ["vendor", "generated"]，否则staticcheck会在protobuf生成代码里狂报错。
把run.timeout设为2m以上，小项目无所谓，但vendor或generated目录多时容易超时失败。
对测试文件豁免资源检查：run: --skip-dirs="testdata|_test"，避免sql.Rows在mock场景误报。
