go get在国内超时或失败主因是proxy.golang.org及github.com等直连不稳定,需设GOPROXY=https://goproxy.cn,direct实现代理+直连兜底,并配GONOSUMDB解决私有模块校验问题。

为什么 go get 在国内经常超时或失败
因为 Go 官方模块代理 proxy.golang.org 和源码仓库(如 github.com)在国内直连不稳定,DNS 污染、TLS 握手失败、连接重置都很常见。不是 Go 本身有问题,而是网络路径受阻——模块下载走的是 HTTPS 请求,中间经过多个节点,任一环节卡住都会表现为 timeout 或 connection refused。
设置 GOPROXY 的三种可靠方式(按优先级推荐)
Go 1.13+ 默认启用代理模式,只需设对 GOPROXY 环境变量。国内目前最稳的是清华和七牛的镜像,二者都支持完整语义化版本解析和校验:
- 全局生效(推荐):
go env -w GOPROXY=https://goproxy.cn,direct
(goproxy.cn由七牛维护,响应快、同步及时) - 临时生效(调试用):
GOPROXY=https://goproxy.tuna.tsinghua.edu.cn,direct go get github.com/gin-gonic/gin
- 项目级配置(不建议):在项目根目录放
go.env文件并写入GOPROXY=https://goproxy.cn,但go命令默认不读该文件,需配合GOENV才能生效,容易误配
direct 在代理地址末尾的作用不可省略
如果只设 GOPROXY=https://goproxy.cn,遇到私有模块(比如公司内网 GitLab 地址)会直接 404,因为代理无法回源。加上 ,direct 表示“查不到就跳过代理、直连原始地址”,这是关键兜底逻辑:
- 正确写法:
GOPROXY=https://goproxy.cn,direct - 错误写法:
GOPROXY=https://goproxy.cn(私有模块全挂)或GOPROXY=https://goproxy.cn,https://proxy.golang.org,direct(多代理串联反而增加失败概率) - 验证是否生效:
go env GOPROXY
输出应为https://goproxy.cn,direct
私有模块和 replace 冲突时怎么办
当项目里用了 replace 指向本地路径或内网 Git 地址,而 GOPROXY 又没配 ,direct,go build 会试图去代理上找那个路径,必然失败。此时必须确保:
立即学习“go语言免费学习笔记(深入)”;
-
GOPROXY末尾含,direct - 私有域名(如
git.corp.example.com)加入GONOSUMDB:go env -w GONOSUMDB="git.corp.example.com"
,否则校验和检查会因无法访问官方 checksum 数据库而报错checksum mismatch - 若私有库走 SSH,还需确认
~/.ssh/config中 Host 别名配置正确,go不会自动读取git config的 sshCommand
go.sum 锁死旧版本导致校验失败。这些得靠人工干预,不是换代理就能绕过的。










