推荐使用 golangci-lint 作为 Go 项目静态检查工具，支持多平台安装、项目级 YAML 配置、VS Code 实时集成及 CI/CD 自动化执行，提升代码质量与协作效率。
Go 语言官方不强制要求 Lint 工具，但实际开发中，统一代码风格、提前发现潜在问题、提升协作效率，离不开一套可靠的静态检查流程。推荐使用 golangci-lint —— 它是目前最主流、插件丰富、集成友好的 Go Lint 聚合工具。
安装 golangci-lint
推荐通过二进制方式安装，稳定且无需编译：
- macOS（Homebrew）：brew install golangci-lint
- Linux/macOS（curl）：curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.54.2（替换为最新版本号）
- Windows（choco）：choco install golangci-lint
安装后运行 golangci-lint --version 验证是否生效。
项目级配置 .golangci.yml
在项目根目录创建 .golangci.yml，定义启用的 linter、忽略规则和格式偏好：
立即学习“go语言免费学习笔记（深入）”；
- 启用常用 linter：如 govet（标准检查）、errcheck（未处理错误）、staticcheck（深度语义分析）、gofmt 和 goimports（格式化）
- 关闭低价值检查项：例如 golint 已被弃用，建议禁用；typecheck 通常由 go build 覆盖，可关
- 设置忽略路径或文件：用 exclude-rules 或 skip-dirs 排除 vendor/、mocks/ 或生成代码目录
- 指定超时和并发：避免大型项目卡死，例如 timeout: 2m、concurrency: 4
与编辑器/IDE 集成（VS Code 为例）
让 Lint 结果实时显示在编辑器中，提升反馈速度：
- 安装扩展：Go（by Go Team）
- 在 VS Code 设置中开启：“go.lintTool”: “golangci-lint”
- 可选：启用保存时自动修复（需 linter 支持 fix，如 gofumpt、revive）：“go.lintOnSave”: “package” + “go.formatTool”: “goimports”
重启编辑器后，错误和警告会以波浪线形式出现在代码行下方，悬停可查看详情。
CI/CD 中自动执行检查
在 GitHub Actions、GitLab CI 等流水线中加入 Lint 步骤，防止问题合入主干：
- 先下载并缓存 golangci-lint（避免每次重装）
- 运行命令：golangci-lint run --out-format=github-actions（适配 GitHub Actions 的注释格式）
- 添加 --fix 参数可自动修复部分问题（谨慎用于 CI，建议仅在本地或 pre-commit 使用）
- 失败时退出非零码，使 CI 流程中断，确保质量门禁有效
基本上就这些。配置一次，后续所有成员和自动化流程都能受益，不复杂但容易忽略。
