先确认GOPRIVATE是否正确配置为路径前缀(如gitlab.example.com/*),并搭配GO111MODULE=on;再验证go list -m all能否列出私有模块,否则golangci-lint因依赖未加载而报unknown revision或no Go files。

golangci-lint 跑不起来,报 unknown revision 或 no Go files?先看 GOPRIVATE
私有模块未被正确识别时,golangci-lint run 会卡在 go list 阶段,表现是:报 unknown revision、no Go files in current directory,甚至静默退出。这不是 linter 本身的问题,而是 Go 模块系统根本没加载到你的私有依赖。
核心原因:golangci-lint 启动时会调用 go list -m all 构建包图,若未配置 GOPRIVATE,Go 就会试图走代理(GOPROXY)拉取私有路径,并校验 checksum(GOSUMDB),两者都必然失败。
-
GOPRIVATE必须设为路径前缀,不是域名通配 —— 写gitlab.example.com/*,别写*.example.com - 多个域名用逗号分隔,**不能有空格**:
GOPRIVATE=gitlab.example.com/*,github.com/my-org/* - 必须搭配
GO111MODULE=on,否则模块机制不生效,golangci-lint退化为 GOPATH 模式,直接忽略go.mod - 验证是否生效:在项目根目录运行
go list -m all | grep your-private-domain,应能列出私有模块版本
子模块里跑 golangci-lint 报 cannot find module?确认模块自洽性
多模块仓库(monorepo)中,直接在子模块目录下执行 golangci-lint run 失败,常见报错是 cannot find module providing package。根本不是配置文件缺失,而是该子模块未被 Go 视为“独立可构建单元”。
- 子模块目录下必须存在合法
go.mod,且module声明值要与实际仓库路径一致(如module gitlab.example.com/team/api) - 执行前先手动验证:
go list -m应输出模块名,而非command-line-arguments - 不要从父目录用
golangci-lint run ./submodule—— 这会让工具当普通目录扫,不触发模块解析逻辑 - 推荐做法:
cd submodule && golangci-lint run -c ../.golangci.yml(显式指定父级配置,避免继承问题)
.golangci.yml 里怎么让私有模块不被误报?重点关掉 typecheck
私有模块若含生成代码(如 pb.go、mock_*.go)、或依赖未公开的 internal 接口,启用 typecheck 会导致 panic 或超时 —— 它会尝试完整类型检查,但私有依赖的源码往往不可达。
立即学习“go语言免费学习笔记(深入)”;
- 必须在配置中显式禁用:
disable: [typecheck, golint](golint已归档,typecheck与go build冗余且易冲突) - 用
skip-dirs排除生成代码目录:- internal/gen、- api/pb、- mock - 对私有模块的 import 路径做
issues.exclude,避免govet因无法解析 vendor 包而报错 - 若子模块间有 replace 依赖,确保
run.modules-download-mode: readonly,防止 lint 过程意外改写go.sum
CI 中 golangci-lint 突然失败?检查 GOPROXY 和 git 认证链
本地能过、CI 报 x509 certificate signed by unknown authority 或 404 Not Found,大概率是环境变量和 git 认证没对齐。
-
GOPROXY在 CI 中不能只设https://goproxy.cn,必须加direct回退:GOPROXY=https://goproxy.cn,direct - 私有 Git 仓库认证靠系统
git:HTTPS 方式需提前注入git config --global url."https://token@github.com".insteadOf "https://github.com";SSH 方式需挂载私钥并设置ssh-agent - CI runner 的 Go 版本若低于 1.16,
GOPRIVATE的通配符匹配可能失效,建议锁死1.21或更高 - 避免在 CI 脚本里拼接环境变量(如
GOPRIVATE=$DOMAIN/*),shell 变量展开易出空格或截断,直接硬编码更稳
真正容易被忽略的是:golangci-lint 本身不下载模块,它完全依赖 Go 工具链的状态。只要 go list 过不去,后面所有 linter 都不会启动 —— 所以排查永远从 go list -m all 开始,而不是一上来就调配置文件。


















