用途:该技能将 lint 视为 Go 开发流程的一等环节,帮助完成 golangci-lint 的配置、运行、告警解读与修复,并支持在 CI 中落地。
主要能力:golangci-lint 聚合 100+ 个 linter 到单一二进制,并行运行并采用统一配置格式;建议每个 Go 项目都应有 .golangci.yml 作为启用哪些 linter 及如何配置的权威来源;提供生产级推荐配置(资料中分别提到 48 个与 33 个 linter,两处数字不一致);支持自动修复与格式化;提供权威的 nolint 抑制规范。
必要用法:安装 go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest。常用命令保持原样:golangci-lint run ./...、golangci-lint run --fix ./...、golangci-lint fmt ./...、golangci-lint run --enable-only govet ./...、golangci-lint linters、golangci-lint run --verbose ./...。推荐 Makefile 目标 lint、lint-fix、fmt。建议每次重要修改后运行 linter,提交前格式化。旧代码可采用 issues.new-from-rev 只检查新代码并逐步清理,或对旧代码库用最多 5 个并行子代理分别处理自动修复、安全、错误处理、风格格式与代码质量。
限制与注意://nolint 必须写明 linter 名与理由,禁止无理由整体抑制,naintlint 会检查这两点;安全类 linter(gosec、bodyclose、sqlclosecheck)不应随意抑制;告警格式为 文件:行:列: 信息 (linter 名)。v1 配置升级后用 golangci-lint migrate 转换。CI 流水线、GitHub Actions 与 golangci-lint-action 的具体配置资料中未提供,需参考相关技能。