korjavin/golangci-lint

korjavin/golangci-lint 镜像文档

镜像概述和主要用途

korjavin/golangci-lint是一个Docker化的golangci-lint工具镜像。golangci-lint是Go语言生态中广泛使用的代码静态分析工具，集成了多种代码检查器（如golint、go vet、staticcheck等），可检测代码中的潜在问题、风格不一致、性能隐患等。本镜像将golangci-lint打包为容器，用户无需在本地安装工具及其依赖，直接通过Docker命令即可对Go项目进行代码质量检查。

核心功能和特性

• 无依赖部署：无需本地安装golangci-lint及相关依赖，通过Docker容器即可运行，避免环境冲突
• 完整工具集成：包含golangci-lint全部功能，支持标准代码检查规则和自定义配置
• 轻量级使用：支持--rm参数自动清理容器，检查完成后无残留资源占用
• 灵活目录挂载：可将本地Go项目目录挂载到容器内，直接对本地代码进行检查

使用场景和适用范围

• Go语言项目开发中的本地代码质量检查
• CI/CD流程集成，作为代码提交前的质量门禁
• 多开发环境下统一代码检查工具版本，确保检查结果一致性

使用方法和配置说明

基本使用命令

bash
docker run -v $(pwd):/go/src/namespace/project -w /go/src/namespace/project --rm korjavin/golangci-lint run

命令参数详解

• -v $(pwd):/go/src/namespace/project：将当前工作目录（$(pwd)）挂载到容器内的/go/src/namespace/project路径，使容器可访问本地项目代码
• -w /go/src/namespace/project：设置容器工作目录为挂载路径，确保检查在项目根目录执行
• --rm：容器运行结束后自动删除，避免残留容器占用系统资源
• korjavin/golangci-lint：镜像名称
• run：golangci-lint的核心命令，启动代码检查流程

自定义配置支持

若项目根目录存在golangci.yml（golangci-lint标准配置文件），挂载后容器会自动读取该配置，按自定义规则执行检查，无需额外参数。

使用示例

检查当前目录下的Go项目：

bash
# 进入Go项目根目录
cd /path/to/your/go/project

# 执行代码检查
docker run -v $(pwd):/go/src/myproject -w /go/src/myproject --rm korjavin/golangci-lint run

（注：/go/src/myproject可替换为任意容器内路径，保持与挂载路径一致即可）