CI 中应使用官方脚本安装 golangci-lint，禁用 go install；因其每次执行均需拉取依赖并编译，易受 Go 版本、代理及网络影响，属官方明确反对的反模式。
直接用官方脚本装，别用 go install，否则 CI 里会反复失败。
为什么 go install 在 CI 里是反模式
GitHub Actions 或 GitLab CI 中写 go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.59.1 看似干净，实则每次都要拉依赖、编译二进制，极易因 Go 版本波动、proxy 不稳定或网络超时中断。这不是“升级”，是把构建瓶颈主动塞进流水线。
- 官方明确标注这是 典型反模式（2026年6月13日文档）
- 本地开发可以接受，CI 必须预装二进制
- 若坚持用
go install，至少加-mod=readonly防止意外改go.mod
推荐升级路径：脚本安装 + PATH 校验
Mac 用户优先走 Homebrew；Linux 用户用官方脚本最稳，关键在路径和权限两步不能跳过：
- Mac：
brew install golangci-lint或brew upgrade golangci-lint - Linux：
curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.59.1 - 执行完立刻验证：
which golangci-lint输出必须落在$(go env GOPATH)/bin内 - 若输出为空，说明
$(go env GOPATH)/bin没进PATH，补一句export PATH=$(go env GOPATH)/bin:$PATH到 shell 配置 - 检查权限：
ls -l $(which golangci-lint)确保有可执行位（-rwxr-xr-x）
升级后配置与行为兼容性要手动核对
新版 golangci-lint 可能默认启用新 linter、调整告警级别，甚至改变 JSON 输出结构——尤其影响 CI 解析结果的脚本。
- 运行
golangci-lint help linters对比新旧版启用列表，关注是否多了nilness或typecheck这类重型检查器 - 本地先跑一次
golangci-lint run --out-format=json > lint.json，用jq '.issues[0].linter'看字段名是否变化 -
.golangci.yml里若用了enable显式列表，确认新加的 linter 是否被意外排除（新版默认集可能已变） - 若 CI 报
undefined: xxx，不是工具问题，而是 Go module 模式没对齐：检查go version和go env GO111MODULE是否都生效，go.mod的godirective 是否 ≥ 当前 Go 版本
真正麻烦的不是装上新版本，而是不同 Go 版本下 linter 行为不一致——比如 staticcheck 在 Go 1.24 和 1.25 对泛型约束的检查粒度就不同，升级后得同步验证项目实际代码是否触发新规则。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
