在Golang项目中，依赖下载速度直接影响构建效率。当网络访问官方模块仓库不稳定时，使用模块代理能够有效加速依赖获取并提升整体构建速度。通过简单的环境变量配置，开发者可以无缝切换下载源。
什么是Golang模块代理
Golang模块代理是一个遵循GOPROXY协议的中间服务，它缓存公共模块版本，接收go命令的下载请求并返回对应文件。常见的公共代理如proxy.golang.org，国内也有许多镜像可用。使用代理后，go工具链不再直连源码托管站，而是从代理拉取zip和mod文件。
配置GOPROXY环境变量
最直接的方式是设置环境变量GOPROXY。可以指定一个或多个代理地址，用逗号分隔，最后的direct表示回退到直接克隆。
# 设置公共代理，失败时使用 direct export GOPROXY=https://proxy.golang.org,https://goproxy.cn,direct # Windows PowerShell 中设置 $env:GOPROXY = "https://goproxy.cn,direct"
配置完成后，执行go env命令可以确认当前值：
go env GOPROXY
加速私有仓库下载
公司内部的私有模块不应经过公共代理。使用GOPRIVATE变量可以声明这些仓库前缀，让go命令跳过代理和校验。
# 设置私有仓库前缀，多个用逗号分隔 export GOPRIVATE=git.ipipp.com,github.com/mycompany
这样，匹配前缀的模块将直接通过版本控制工具下载，而其余公共依赖走代理加速。
在代码中验证代理效果
我们可以写一个简单的Go程序，在构建时观察模块拉取过程。开启verbose日志即可看到请求地址。
package main
import (
"fmt"
"runtime"
)
func main() {
// 打印 Go 版本与运行时，验证构建环境
fmt.Println("Go version:", runtime.Version())
}
使用如下命令构建并查看详细日志：
go build -x -mod=mod 2>&1 | grep -i proxy
常见问题与建议
- 代理地址建议使用HTTPS，避免中间人篡改。
- 若使用本地缓存，可配合GOCACHE提升重复构建速度。
- CI环境中固定代理地址，保证构建可重现。
通过合理设置Golang模块代理，依赖下载与项目构建的耗时通常能降低数倍，是团队提效的基础实践。