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 配正则，而不是靠注释。