如何使用Golang处理模块下载代理_配置GOPROXY提高下载速度

推荐优先使用 https://goproxy.cn，它兼容 Go 1.13+，自动处理校验和，且对私有仓库支持较好；设置方式包括临时 export、永久 go env -w 和单次命令覆盖，并需配合 GOPRIVATE 跳过私有模块代理。

直接配置 GOPROXY 是提升 Go 模块下载速度最简单有效的方式，尤其在国内访问官方 proxy.golang.org 常常缓慢或失败。设置一个可靠的代理地址，能让 go get、go mod download 等命令跳过直连，从国内镜像快速拉取模块。

常用 GOPROXY 配置地址

目前稳定可用的公开代理主要有：

• https://goproxy.cn（七牛云维护，国内首选，支持 HTTPS 和私有模块）
• https://proxy.golang.org（官方代理，海外访问快，国内不稳定）
• https://goproxy.io（已停止维护，不建议使用）
• https://mirrors.aliyun.com/goproxy/（阿里云镜像，可用但偶尔同步延迟）

推荐优先使用 https://goproxy.cn，它兼容 Go 1.13+，自动处理校验和，且对私有仓库支持较好（配合 GOPRIVATE 可绕过代理）。

设置 GOPROXY 的三种方式

Go 会按顺序读取环境变量、go env -w 配置、命令行参数，优先级从高到低：

• 临时设置（当前终端生效）：
  export GOPROXY=https://goproxy.cn,direct
• 永久设置（推荐）：
  go env -w GOPROXY=https://goproxy.cn,direct
  执行后会写入 $HOME/go/env，所有后续终端自动生效。
• 单次命令覆盖：
  GOPROXY=https://goproxy.cn go get github.com/sirupsen/logrus

注意末尾的 ,direct：表示对 GOPRIVATE 中指定的私有域名（如公司内网模块）不走代理，直接拉取，避免泄露或认证失败。

配合 GOPRIVATE 跳过私有模块代理

如果你的项目依赖公司内部 Git 仓库（如 git.company.com/my/lib），必须跳过代理，否则会 404 或鉴权失败：

• 设置私有域名前缀：
  go env -w GOPRIVATE=git.company.com
• 支持通配符：
  go env -w GOPRIVATE=*.company.com,github.company.internal
• 多个用逗号分隔，无需空格。

设置后，Go 会自动对匹配域名的模块跳过 GOPROXY，改用 git clone 或 https 下载，并尊重 ~/.netrc 或 Git 凭据管理器。

验证和排错小技巧

配置完可以快速检查是否生效：

• 查看当前值：
  go env GOPROXY
• 触发一次模块下载并观察日志：
  go mod download -x github.com/go-sql-driver/mysql@v1.7.1
  输出中若出现 GET https://goproxy.cn/github.com/go-sql-driver/mysql/@v/v1.7.1.info 即表示走代理成功。
• 如果仍慢或报错，检查是否漏设 GOPRIVATE，或代理地址拼写错误（注意是 https，不是 http）。

不复杂但容易忽略。