Golang 模块加载慢？依赖缓存与代理优化技巧

配置国内代理并清理缓存可显著提升Go模块加载速度。首先设置GOPROXY为https://goproxy.cn,direct，使用七牛云等国内镜像加速下载；通过go env -w应用配置后执行go mod download验证速度。接着清理本地缓存避免干扰：运行go clean -modcache清除模块缓存，必要时删除GOCACHE目录。对于私有模块需配置GONOPROXY和GONOSUMDB跳过代理与校验，并确保SSH免密访问。最后优化go.mod，运行go mod tidy去除冗余依赖，检查并升级异常模块版本，锁定关键依赖减少解析开销。合理设置代理、缓存与依赖管理，即可解决模块加载慢问题。

Go 模块加载慢通常是因为每次拉取依赖都要访问国外的源，网络不稳定导致超时或重试。解决这个问题的核心是配置国内代理和合理利用本地缓存。只要设置正确，模块下载速度可以从几分钟缩短到几秒。

启用 Go Module 代理加速

Go 支持通过 GOPROXY 环境变量指定模块代理服务。使用国内镜像能大幅提升下载速度。

• export GOPROXY=https://goproxy.cn,direct（七牛云代理，稳定快速）
• 也可以用：https://goproxy.io 或阿里云的 https://mirrors.aliyun.com/goproxy/
• 多个地址用逗号分隔，direct 表示最终回退到源站

验证是否生效：

go env -w GOPROXY=https://goproxy.cn,direct

执行 go mod download 观察下载速度变化。

清除无效缓存避免干扰

本地模块缓存损坏或版本残留可能导致重复拉取或失败。

• 查看缓存路径：go env GOCACHE 和 go env GOMODCACHE
• 清理模块缓存：go clean -modcache
• 必要时清空 GOCACHE：rm -rf $(go env GOCACHE)

清理后重新触发下载，确保获取的是最新且完整的依赖包。

私有模块与企业环境处理

如果项目包含私有仓库（如 GitHub 私有库、GitLab 内部模块），需单独配置跳过代理。

• 设置 GONOPROXY：指定不走代理的域名
  e.g. go env -w GONOPROXY=git.company.com
• 配合 GONOSUMDB 跳过校验：go env -w GONOSUMDB=git.company.com
• 确保 SSH 配置正确，支持免密拉取私有库

优化 go.mod 减少冗余依赖

过多间接依赖会延长解析时间。保持 go.mod 简洁有助于提升加载效率。

• 定期运行 go mod tidy 删除未使用的依赖
• 检查 go list -m all | grep 'incompatible'，升级异常模块
• 锁定关键版本，避免频繁重新解析

基本上就这些。代理 + 缓存 + 合理配置，Golang 模块加载不再卡顿。不复杂但容易忽略。