Go代码检查配置

技能简介

本技能用于配置和排查golangci-lint在Go项目中的使用问题，处理导入解析异常、类型检查失败等情况，并针对本地开发与CI环境提供优化方案。

能做什么

• 生成最小化或标准版linter配置文件
• 诊断”undefined: package”类导入错误
• 解决CI环境中的依赖解析问题
• 修复类型检查阶段的失败
• 输出GitHub Actions工作流示例

使用说明

步骤1：安装golangci-lint

# 方式一：go install
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest

# 方式二：官方脚本（推荐固定版本）
curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.59.1

步骤2：创建配置文件

根据场景选择配置模板：

• CI环境（有导入问题）：使用disable-all: true仅启用gofmt
• 本地开发：启用govet、errcheck、staticcheck等完整规则集

步骤3：执行检查

# 全项目扫描
golangci-lint run ./...

# 指定配置
golangci-lint run --config .golangci.yml ./...

# 快速模式（跳过复杂类型检查）
golangci-lint run --fast ./...

输入与输出

见下方输入与输出表格。

风险提示

• 部分linter需要完整类型信息，缺失依赖会导致误报
• CI环境建议先执行go mod download再运行linter
• 版本升级可能引入新规则，导致原有代码无法通过检查
• 过多linter并行运行会显著增加构建时间

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/irook661/go-linter-configuration/SKILL.md
来源类型：开源社区技能库