Go 1.13起默认启用GOPROXY，依赖下载加速依赖代理（如goproxy.cn）与本地模块缓存（$GOPATH/pkg/mod），首次下载后复用本地缓存，配合CI/CD持久化或私有Proxy实现高效复用。
Go 1.13 起官方默认启用 GOPROXY，本地包缓存主要通过 Go Proxy 缓存代理 实现，而非传统意义上的“本地磁盘缓存包源码”。真正提升依赖下载速度的关键，是让 Go 命令复用已下载的模块，避免重复拉取。核心机制是 go mod download + GOPATH/pkg/mod/cache 本地模块缓存，再配合私有或国内代理（如 proxy.golang.org 的镜像）减少网络延迟。
启用并验证 GOPROXY（国内加速必备）
Go 默认使用 https://proxy.golang.org，但该地址在国内不稳定。推荐切换为可信镜像：
- 执行命令设置全局代理：
go env -w GOPROXY=https://goproxy.cn,direct -
direct表示对私有域名（如git.company.com）跳过代理，直连下载 - 验证是否生效：
go env GOPROXY应输出设置的地址
理解并利用本地模块缓存目录
Go 自动将下载的模块存入 $GOPATH/pkg/mod/cache/download/（v0.x.y 版本）和 $GOPATH/pkg/mod/（解压后的模块树），无需手动配置。
- 首次
go build或go mod download会拉取模块并缓存，后续构建直接读本地，不走网络 - 可手动预热缓存：
go mod download下载go.mod中所有依赖到本地 - 清理缓存用
go clean -modcache（慎用，会清空全部已缓存模块）
在 CI/CD 或多项目环境中复用缓存
避免每次构建都重新下载，关键在于持久化 $GOPATH/pkg/mod 目录：
立即学习“go语言免费学习笔记（深入）”；
- Docker 构建时：挂载宿主机缓存目录，或使用
go mod download阶段单独缓存 layer - GitHub Actions：用
actions/cache@v4缓存~/go/pkg/mod - 团队共享缓存：可通过 NFS 或对象存储部署私有 Go Proxy（如 Athens），实现跨机器复用
调试缓存是否生效的小技巧
运行 go list -m -u all 或 go build -v，观察输出中是否有 finding、downloading 字样：
- 若只显示
github.com/some/pkg v1.2.3无下载日志，说明来自本地缓存 - 加
-x参数（如go build -x）可看到完整命令流，确认是否调用curl请求远程 - 临时禁用代理测试：
GOPROXY=off go build，若失败则说明之前确实在走代理+缓存
不复杂但容易忽略：只要 GOPROXY 设置正确 + 模块版本固定（go.mod 中有 // indirect 或明确版本），本地缓存就会自然生效。不需要额外工具或配置文件。
