golangci-lint 是 Go 社区事实标准的静态检查聚合器，替代 go vet、golint 等工具，统一配置与执行；值得在项目中强制使用，尤其适用于 CI 卡点、团队规范和低级错误防控。
golangci-lint 是什么，值不值得在项目里用？
它不是“可选工具”，而是当前 Go 社区事实标准的静态检查聚合器。直接替代 go vet、golint（已弃用）、staticcheck 等单个工具，统一配置、统一执行、统一输出。如果你的项目需要 CI 卡点、团队统一规范或避免低级错误漏检，golangci-lint 就是必选项。
怎么安装和快速跑起来？
别用 go get（官方明确不推荐），直接下载二进制：
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
首次运行建议加 -v 看详细信息，避免误以为没结果：
立即学习“go语言免费学习笔记（深入）”；
golangci-lint run -v
- 默认只检查当前目录下
.go文件，不递归子模块（除非有go.mod） - 若报错
no go files to analyze，确认是否在正确 module 根目录，或加--modules参数（慎用，可能触发跨 module 误报） - 第一次运行慢，因为要下载 linters 插件缓存；后续会快很多
如何配置 .golangci.yml 避免误报和过度检查？
默认配置太激进，尤其对新项目或小团队，容易被一堆 stylecheck 或 gosimple 报警劝退。关键原则：先关掉非安全/非功能性问题的 linter，再逐步打开。
最小可行配置示例（放在项目根目录）：
run:
timeout: 5m
skip-dirs:
- vendor
- testdata
<p>linters-settings:
errcheck:
check-type-assertions: true
govet:
check-shadowing: true</p><p>linters:
enable:</p><ul><li>errcheck</li><li>govet</li><li>staticcheck</li><li>unused
disable:</li><li>gosimple</li><li>stylecheck</li><li>funlen</li><li>gosec # 安全扫描，需单独评估是否启用-
unused检查未使用变量/函数，但会误报导出符号（如func Exported()被其他包调用时）→ 配合//nolint:unused注释临时跳过 -
staticcheck强力推荐保留，它能发现time.Now().UTC().Format(...)这类时区隐患，比go vet更深 - 禁用
gosec不代表放弃安全检查，它依赖 AST 分析，在某些泛型或嵌套闭包场景会 panic，稳定后再启用
怎么集成到 CI 和 pre-commit？
CI 中最常见失败原因是本地能过、CI 报错——往往因为 Go 版本或 linter 版本不一致。必须锁死版本：
# .github/workflows/lint.yml
- name: Run golangci-lint
uses: golangci/golangci-lint-action@v3
with:
version: v1.54.2 # 必须和本地一致
args: --timeout=5mpre-commit hook 建议用 shell 脚本封装，避免每次提交都扫全量：
#!/bin/sh # .githooks/pre-commit golangci-lint run --fix --new-from-rev=HEAD~1
-
--new-from-rev=HEAD~1只检查本次 commit 新增/修改的代码，速度快、反馈准 -
--fix自动修复部分问题（如gofmt、goimports类型），但不能修复逻辑问题 - 别把
golangci-lint当格式化工具用；格式化交给go fmt或gofumpt
真正麻烦的是跨团队协作时，有人改了 .golangci.yml 却没同步更新 CI 配置，导致 PR 状态不一致。配置文件本身就得进 CI 流水线做 diff 校验。
