go get报connection refused主因是默认GOPROXY=https://proxy.golang.org被墙,应配置为https://goproxy.cn,direct(逗号无空格、direct小写),并视情况设置GOSUMDB=off和GOPRIVATE。

go get 报 connection refused,先看是不是 proxy.golang.org 在捣鬼
国内环境下 go get 或 go mod download 报 connection refused,90% 是因为 Go 默认用了被墙的 https://proxy.golang.org。这个地址在国内根本连不通,TCP 连接直接被拒绝,不是超时,是“拒之门外”。
它不是你本地代理没开,也不是网络断了,而是 Go 工具链硬编码优先尝试这个域名。
- 执行
go env GOPROXY,如果输出是https://proxy.golang.org,direct或空值,就坐实了问题 - 别信终端里能 ping 通或浏览器能打开 —— Go 的 HTTP client 不走系统 DNS 缓存,也不走浏览器代理,它直连
-
direct在列表末尾只是 fallback,前面那个失败后才轮到它;但connection refused会卡住,不往下试
GOPROXY 必须设成可用镜像 + direct,且逗号不能错
正确配置是让 Go 先连国内镜像,失败再直连私有模块。最稳妥写法只有一种:https://goproxy.cn,direct(注意:英文逗号、无空格、direct 小写、无协议头)。
- 错误示例:
https://goproxy.cn, direct(带空格)→ 报invalid proxy URL missing scheme: direct - 错误示例:
https://goproxy.cn;direct(中文或分号)→ 整个 GOPROXY 解析失败,退回到默认值 - Windows PowerShell 用户:用
$env:GOPROXY="https://goproxy.cn,direct",别用set(cmd 命令),两者不互通 - VS Code 用户:必须从终端启动(
code .),否则不继承 shell 的export GOPROXY=...
gopls 安装失败?大概率是 GOPROXY 没生效,不是插件问题
go install gopls@latest 卡住或报 Get https://proxy.golang.org/...: dial tcp ...: connection refused,说明 gopls 的依赖拉取也走 GOPROXY,而你设的值没被读到。
- 在 VS Code 内置终端运行
go env GOPROXY,输出必须是你设的值;如果还是https://proxy.golang.org,direct,说明环境变量没加载 - macOS/Linux:确认
~/.zshrc或~/.bashrc里有export GOPROXY=https://goproxy.cn,direct,且已source过 - Windows:在「系统属性 → 环境变量」里添加用户变量
GOPROXY,值填https://goproxy.cn,direct,然后彻底关闭并重启 VS Code - 验证是否通:跑
go list -m -f '{{.Dir}}' golang.org/x/tools,不卡即代理通,卡住说明还没绕过proxy.golang.org
连 goproxy.cn 都 connection refused?检查 GOSUMDB 和证书
极少数情况,连 https://goproxy.cn 都报 connection refused,可能有两个隐藏原因:
立即学习“go语言免费学习笔记(深入)”;
-
GOSUMDB强制校验时仍会直连sum.golang.org:即使 GOPROXY 换了,Go 默认仍要向官方 sumdb 校验哈希,而该域名同样被墙。临时解决:运行go env -w GOSUMDB=off - 公司内网或某些国产杀毒软件劫持 HTTPS 流量,导致 TLS 握手失败:错误信息通常是
tls: first record does not look like a TLS handshake。此时需把私有代理 URL 改为http://(不推荐)或联系 IT 加入白名单 - 别忽略
GOPRIVATE:私有模块如gitlab.example.com/myproj必须加进GOPRIVATE,否则 Go 会跳过 GOPROXY 直连,又掉回connection refused
GOSUMDB 的静默校验、IDE 启动方式导致的环境变量丢失、或者一个中文逗号毁掉整个配置。


















