用途:为 Go 项目建立一致的代码检查流程,配置 golangci-lint,并将 Go 检查加入 CI/CD 流水线,也适用于启动新 Go 项目时的 lint 初始化。核心原则是让 lint 在整个代码库中保持一致,以捕捉常见问题、建立较高代码质量基线,同时避免过度约束。
主要能力:提供资源路由,scripts/setup-lint.sh 用于生成 .golangci.yml、验证首次 lint 结果或输出 JSON 元数据;assets/golangci.yml 作为既有项目的 v2 golangci-lint 基线配置。推荐最小 linter 集:errcheck(错误处理)、goimports(格式化与导入管理)、revive(风格,golint 的现代替代)、govet、staticcheck。生产项目可考虑 gosec、ineffassign、misspell、gocyclo、exhaustive、bodyclose,资料中说明了各自的用途与启用时机。
使用方式:创建 .golangci.yml 或复制 assets/golangci.yml;运行 golangci-lint run ./...,按类别修复(先格式化,再 vet,再风格)直至通过;生成配置后运行 golangci-lint config verify --config .golangci.yml 校验 schema。安装命令为 go install github.com/golangci/golangci-lint/v2/cmd/golangci-lint@v2.10.1。也可运行 golangci-lint run ./pkg/... 指定路径。CI 中在测试之后运行 golangci-lint run ./... 并固定版本;GitHub Actions 使用 golangci/golangci-lint-action。pre-commit 钩子使用 golangci-lint run --new-from-rev=HEAD~1 只检查改动代码。
限制与注意事项:抑制告警必须使用 //nolint:lintername // 理由,禁止裸 //nolint,注释需与告警同一行并说明原因。示例配置针对 golangci-lint v2(以 2.10.1 验证)。资料未提供具体收费、价格或额外平台信息。