golangci-lint 是 CI 中 Go 静态检查首选工具，需配置 .golangci.yml、禁用 --fast 主干构建、设 issues-exit-code: 1，并用预编译二进制安装；输出格式适配平台（如 GitHub Actions 用 github-actions），抑制规则须带理由且精准到行/函数/文件。
用 golangci-lint 在 CI 中做静态检查
CI 流程里集成 Go 代码质量检查，golangci-lint 是目前最主流、最稳定的选择。它不是单个 linter，而是多个 linter 的聚合器（比如 go vet、errcheck、staticcheck），支持配置合并、并行执行和缓存，适合跑在资源受限的 CI 环境中。
关键点：别直接用 go vet 或单个 linter —— 覆盖不全、配置分散、CI 脚本易膨胀。
- 推荐在项目根目录放
.golangci.yml，而不是命令行拼一堆 flag - CI 中运行时加
--fast可跳过耗时检查（如unused），但仅限 PR 构建；主干构建建议关掉 - 务必设
issues-exit-code: 1，否则 lint 报错不会导致 CI 失败 - 如果用 GitHub Actions，避免用社区维护的
actions/setup-go后再go install安装golangci-lint—— 改用预编译二进制（见下条）
GitHub Actions 中高效安装 golangci-lint
很多 CI 脚本用 go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.54.2，这会导致每次运行都拉依赖、编译，慢且不稳定（Go 版本或 proxy
波动时容易失败）。
更可靠的做法是直接下载官方发布的静态二进制：
立即学习“go语言免费学习笔记（深入）”；
curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.54.2
或者在 GitHub Actions 中用官方 action（注意版本对齐）：
uses: golangci/golangci-lint-action@v3 with: version: v1.54.2 args: --config .golangci.yml
这个 action 内部就是下载二进制，不走 go install，失败率低、启动快。
如何让 lint 结果可读且可追踪
CI 日志里只打印几十行 lint 错误，开发人员很难快速定位问题。需要把结果导出为机器可解析格式，并对接到 UI 或评论系统。
- 用
--out-format=github-actions让错误自动标记在 PR 的对应代码行（GitHub Actions 原生支持） - 若用 GitLab CI，改用
--out-format=checkstyle，再配合gitlab-ci-lint-report解析 - 本地开发时加
--fix自动修正部分问题（如格式、import 排序），但 CI 中禁用 —— 避免因格式修改触发二次构建 - 在
.golangci.yml里用skip-dirs排除vendor/、internal/testdata等非业务目录，减少噪音
忽略规则要精确到文件或行，而非全局关闭
遇到某条 lint 规则误报，第一反应不该是 disable-all: true 或整个禁用 golint，而是局部抑制。
支持三种粒度：
- 行级：
//nolint:govet（紧贴报错行上方） - 函数级：
//nolint:errcheck // ignore close error（放在 func 上方） - 文件级：
//nolint:unparam,goconst（文件顶部注释）
所有 //nolint 注释必须带理由，否则会被 revive 或自定义规则拦截 —— 这条本身就应该写进你们的 .golangci.yml。
真正难处理的是跨包接口实现类问题（比如某个 io.Reader 实现故意不检查 Read 返回的 n），这种得靠 exclude-rules 配正则，而不是靠注释。
