CI中缓存不生效的典型现象是运行golangci-lint run -v无cache hit日志、同commit耗时大幅波动、GOLANGCI_LINT_CACHE已设却仍重解析包;主因是缓存路径未稳定复用,须固定路径(如/tmp/golangci-cache)、挂载持久化卷(actions/cache或cache:paths),并配合--skip-dirs硬过滤vendor等目录。

CI 中缓存不生效的典型现象
运行 golangci-lint run -v 时看不到 cache hit 或 loaded from cache 日志;同一 commit 多次触发 CI,耗时波动极大(比如从 8s 跳到 42s);GOLANGCI_LINT_CACHE 环境变量已设,但每次仍从头解析所有包。这些都不是配置漏了,而是缓存路径不稳定或未复用。
必须固定 GOLANGCI_LINT_CACHE 路径并挂载卷
CI 环境默认不保留文件,缓存目录若没挂载就等于没开:
- GitHub Actions:必须用
actions/cache持久化/tmp/golangci-cache,且key要含golangci-lint-version和go-version,否则不同 Go 版本混用缓存会静默失效 - GitLab CI:在
cache:paths显式写/tmp/golangci-cache,同时在before_script中设export GOLANGCI_LINT_CACHE=/tmp/golangci-cache - 别用
$HOME/.cache/golangci-lint:CI runner 是无状态容器,$HOME每次重建,路径存在但内容清空
缓存路径和模块解析冲突会导致失败
如果项目用了 replace 指向本地路径,或 go.mod 里有未提交的 require,golangci-lint 会在缓存加载阶段报 failed to load program: typechecker error 或 package xxx is not in GOROOT。这不是缓存问题,是模块环境不一致:
- 确保
go build ./在 CI 中能成功——这是 lint 前置条件 - 在
.golangci.yml的run段加modules-download-mode: readonly,防止并发下抢锁导致卡死 - 禁用
typechecklinter:它和go build功能重叠,又极易因模块解析失败而中断整个 lint 流程
缓存不是万能的,跳过 vendor/testdata 才是第一提速动作
即使缓存全开,首次扫描 vendor/ 下几万个文件仍要十几秒。缓存只加速“已分析过”的部分,无法绕过初始遍历:
立即学习“go语言免费学习笔记(深入)”;
- 用
--skip-dirs vendor,testdata,examples,scripts参数硬过滤,比靠配置文件run.skip-dirs更早生效 - CI 脚本中显式传参,不要依赖
.golangci.yml自动加载——避免配置未被读取时 fallback 到默认行为(默认扫全部) - 生成代码目录如
internal/gen、pb.go所在路径也得加进--skip-dirs,否则errcheck会对proto.Unmarshal报一堆误报


















