golangci-lint不是装完即用的工具：必须通过二进制安装、严格使用.golangci.yml（与go.mod同级）、显式启用govet/errcheck/staticcheck/unused/revive五大核心linter，并在ci/ide中强制指定--config参数，否则检查形同虚设。
golangci-lint 不是装完就能用的工具——它默认只启用 govet 和 errcheck 等寥寥几个检查器，staticcheck、unused、revive 这些真正能揪出 bug 的 linter 全被关着。没配 .golangci.yml，等于没用。
安装必须走二进制，别用 go install
官方明确不建议用 go install，因为会污染 module 缓存、版本混乱、甚至导致 go mod tidy 报错找不到包。
- Mac 用户（zsh）：运行
curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.54.2 - 验证：执行
golangci-lint --version，输出应含1.54.2 - 常见失败现象：
command not found: golangci-lint→ 检查$(go env GOPATH)/bin是否在$PATH中；macOS 用户需确认~/.zshrc里有export PATH="$GOPATH/bin:$PATH"，然后source ~/.zshrc
.golangci.yml 必须和 go.mod 同级，名字不能错
文件名写成 .golangci.yaml、golangci.yml、.golangci.yml.bak 都不行；路径放错（比如项目根目录但 go.mod 在 src/ 下）也会静默失效。
- 正确做法：cd 到
go.mod所在目录，新建.golangci.yml - 多 module 项目（monorepo）：每个 module 目录下都要单独放一份，父目录配置不继承
- CI 或 IDE 中若没报错但检查不生效，大概率是路径或文件名错了 ——
golangci-lint只认严格匹配的.golangci.yml
必须显式启用核心 linter，别信默认配置
默认配置只开保守检查，漏掉大量真实隐患。以下 5 个是实际项目中问题暴露最多、误报可控的组合：
-
govet：Go 官方基础兜底，但默认只开部分子项（如printf），要加checks: ["all"]才能覆盖atomic、bools等 -
errcheck：捕获被忽略的error返回值，强制处理，避免静默失败 -
staticcheck：报SA1019（弃用 API）、SA4006（死循环）等语义级风险 -
unused：发现未导出但未使用的函数/变量/导入，go vet不报 -
revive：替代已弃用的golint，支持自定义规则（如禁止_ = xxx忽略 error） - 禁用
golint和dupl：前者规则主观噪音大，后者阈值难调、易误报
CI 和本地运行必须带 --config 参数
golangci-lint run 在本地可能自动找配置，但在 CI 容器里常因工作目录、缓存或路径问题漏读配置 —— 导致检查形同虚设。
- 安全写法：始终显式指定
golangci-lint run --config=.golangci.yml - VS Code / GoLand：IDE 设置里必须勾选「使用配置」并填对路径，否则插件可能沿用旧缓存
- 大项目容易 OOM 或超时：加
--concurrency=2限制并发数，用--skip-dirs="vendor,third_party"跳过非主代码区域
配置这件事本身不难，难的是它既不报错也不提示“你没配对”，只是安静地少检查一大半问题。最容易被忽略的点是：文件名拼写、路径层级、CI 中缺 --config 参数 —— 这三处一错，整个静态检查就形同虚设。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
