Golang代理设置教程：解决下载慢问题

国内Go开发者常因默认模块代理proxy.golang.org和golang.org访问不稳定而遭遇模块下载缓慢甚至失败，本文手把手教你通过三步轻量配置彻底解决：只需一条命令设置国内高速代理（如goproxy.cn）并启用直连回落，再用GOPRIVATE精准排除私有仓库避免泄露风险，最后确保GO111MODULE=on开启模块功能——全程无需安装额外工具、不改动系统代理，几分钟即可生效，提速立竿见影，是每个国内Go程序员都该掌握的必备基础技能。

国内使用 Go 时下载慢，核心原因是默认模块源 proxy.golang.org 和官网 golang.org 访问不稳定。配置代理不是“可选项”，而是国内开发者的标准动作，几条命令就能明显提速。

设置 GOPROXY 加速模块下载

Go 1.13+ 默认启用 Modules，只需指定一个可靠的国内镜像代理：

• 推荐执行：go env -w GOPROXY=https://goproxy.cn,direct
• https://goproxy.cn 由七牛云维护，响应快、缓存全、长期稳定
• direct 表示当代理无法处理某些模块（如私有域名）时，自动回落直连，不中断流程
• 也可备选：https://mirrors.aliyun.com/goproxy/ 或 https://goproxy.io

排除私有仓库走代理

公司内部 Git 仓库（如 git.company.com、gitlab.internal）不能走公共代理，否则可能泄露代码或认证失败：

• 执行：go env -w GOPRIVATE=*.company.com,gitlab.internal
• 支持通配符和逗号分隔多个域名
• 设置后，这些域名下的模块会跳过代理，直接从源地址拉取

确保模块功能已开启

部分旧环境可能未启用 Modules，导致代理不生效：

• 运行：go env -w GO111MODULE=on
• 新项目建议用 go mod init xxx 初始化，自动生成 go.mod
• 已有项目可运行 go mod tidy 触发模块下载，观察是否提速

验证代理是否生效

别只看命令有没有报错，要确认实际行为：

• 执行：go env | grep -i proxy，检查输出含 GOPROXY 和 GOPRIVATE
• 运行：go get github.com/spf13/cobra@latest，观察下载日志是否显示来自 goproxy.cn
• 若仍超时，检查网络是否拦截 HTTPS 请求，或终端是否被代理工具（如 Clash）干扰

基本上就这些。不需要装额外客户端，也不用改系统级代理，纯环境变量配置，生效快、易回退、适合所有 Go 版本（1.13 及以上）。不复杂但容易忽略。

今天关于《Golang代理设置教程：解决下载慢问题》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！