Go 1.13+ 默认使用 GOPATH/pkg/mod 存储模块缓存,但可通过 GOMODCACHE 环境变量自定义路径,优先级高于 GOPATH;支持多项目隔离、SSD/HDD 分离及 CI/CD 复用,并可配合 GOPROXY 实现离线或加速缓存。

Go 语言从 1.13 版本起默认启用 Go Module,并使用 GOPATH/pkg/mod 作为模块下载和缓存的默认路径。但你可以通过环境变量灵活配置依赖包的存储位置,实现多项目隔离、SSD/HDD 分离、CI/CD 环境复用等目标。
修改模块缓存路径:GOPATH/pkg/mod → 自定义目录
Go 使用 GOPATH 下的 pkg/mod 存放模块缓存,但真正控制缓存根目录的是 GOMODCACHE 环境变量(Go 1.13+ 支持)。它优先级高于 GOPATH,设置后 Go 命令会直接使用该路径缓存模块。
- Linux/macOS:在 shell 配置文件(如
~/.bashrc或~/.zshrc)中添加:export GOMODCACHE="/path/to/your/modcache" - Windows(PowerShell):
$env:GOMODCACHE="D:\go\modcache" - 验证是否生效:
go env GOMODCACHE应返回你设置的路径
配合 GOPROXY 实现离线/加速缓存(可选增强)
GOPROXY 控制模块下载源,而本地缓存仍由 GOMODCACHE 管理。若想进一步统一管理(比如搭建私有代理 + 本地磁盘缓存),可组合使用:
- 设置代理指向本地缓存服务(如 goproxy.io 或 goproxy/goproxy):
export GOPROXY="http://localhost:8080,direct" - 该服务自身会维护一份持久化模块副本,与
GOMODCACHE独立,适合团队共享或断网开发 - 注意:
GOMODCACHE仍是每个开发者本地的“只读缓存”,不上传;代理服务的缓存是“服务端写入缓存”
清理与查看当前缓存状态
缓存路径变更后,旧缓存不会自动迁移,需手动处理:
立即学习“go语言免费学习笔记(深入)”;
- 查看已下载模块列表:
go list -m -f '{{.Path}} {{.Version}}' all - 清空当前缓存(谨慎执行):
go clean -modcache—— 它会删除GOMODCACHE指向的整个目录 - 若想保留部分模块,可直接进入
GOMODCACHE目录,按需删子目录(如github.com/some/repo@v1.2.3)
项目级临时覆盖(适合 CI 或单次构建)
无需全局修改,可在命令前临时指定:
GOMODCACHE="/tmp/go-modcache" go build- Docker 构建中常用:
ENV GOMODCACHE=/go/pkg/mod,并挂载宿主机目录复用缓存 - 注意:这种临时设置对子 shell 或后续命令无效,仅限当前命令生效










