使用docker运行golangci-lint需挂载源码目录到/app、设-w /app、显式传入goproxy，并确保当前目录有.go文件和唯一go.mod，否则报错或静默退出。
在不安装 golangci-lint 本地二进制的前提下，用 Docker 容器快速执行 Go 代码静态检查，需确保源码目录正确挂载、工作目录匹配、Go 代理生效且配置文件可被识别，否则会报“no go files to check”或“failed to load config”。
用官方镜像运行基础检查
执行 docker run --rm -v $(pwd):/app -w /app golangci/golangci-lint:latest-alpine golangci-lint run，容器启动后自动挂载当前目录到 /app，将工作目录切至 /app，并运行一次全量检查。
这一步操作起来很简单，直接把文件拖进去就行。但注意：若当前目录下没有 .go 文件，或未在 /app 下放置 go.mod，则命令会静默退出并返回 0，实际什么都没检查——【必须确认 pwd 下存在至少一个 *.go 文件】。
挂载配置文件与 GOPROXY 设置
方法一：显式指定配置路径
docker run --rm -v $(pwd):/app -v $(pwd)/.golangci.yml:/app/.golangci.yml -w /app -e GOPROXY="https://goproxy.cn" golangci/golangci-lint:latest-alpine golangci-lint run -c .golangci.yml
方法二：依赖默认查找逻辑
只要把 .golangci.yml 放在项目根目录（即 $(pwd)），并挂载进容器同路径，golangci-lint 就会在 /app 下自动识别它，无需 -c 参数。此时只需加 -e GOPROXY="https://goproxy.cn" 即可触发国内模块下载。
【GOPROXY 环境变量必须显式传入，容器内默认为空，否则 mod download 会超时失败】
处理多模块或子目录检查
第一步：进入含 go.mod 的子目录再执行挂载
比如项目结构为 ./backend/go.mod 和 ./frontend/go.mod，你要检查 backend，就 cd backend，再运行 docker run --rm -v $(pwd):/app -w /app -e GOPROXY="https://goproxy.cn" golangci/golangci-lint:latest-alpine golangci-lint run。
第二步：避免跨模块污染
如果不切目录，而用 -v $(pwd):/app 并在 /app/backend 下运行，golangci-lint 可能误读根目录或其他子目录的 go.mod，导致分析路径错乱或插件初始化失败。所以务必保证 -w 路径下有且仅有一个 go.mod。
第三步：指定相对子路径检查
也可不切换宿主机目录，改用 golangci-lint run backend/ —— 这要求挂载的是整个父目录，且 backend/ 是 /app 下的有效子路径。该方式适合 CI 脚本批量触发不同模块。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
