必须显式设置GOPROXY环境变量，推荐export GOPROXY=https://goproxy.cn,direct，因其同步及时、sum校验完整且支持私有模块fallback到direct。

为什么 go mod download 总是卡在 proxy.golang.org

因为国内直连 proxy.golang.org 和 sum.golang.org 不稳定，常出现超时、403 或校验失败。Go 默认不走系统代理，且 GO111MODULE=on 后所有依赖都强制走模块代理，不配置就会反复失败。

• 不是网络问题，是 Go 模块协议本身要求校验 sum 文件，而 sum.golang.org 在国内不可靠
• GOPROXY 是唯一可控入口，必须显式设置，不能依赖环境变量自动继承
• 多个代理可串联，用逗号分隔，Go 会按顺序尝试，直到成功或全部失败

推荐的 GOPROXY 配置值及取舍

优先使用带校验兜底的组合，避免因代理自身缺失 sum 数据导致构建中断：

export GOPROXY=https://goproxy.cn,direct

这是目前最稳的配置 —— goproxy.cn 同步及时、sum 校验完整、支持私有模块 fallback 到 direct。其他常见选项对比：

• https://mirrors.aliyun.com/goproxy/：同步延迟略高，偶发 404，但域名更熟悉
• https://goproxy.io：已停止维护，不建议新项目使用
• https://proxy.golang.org：仅作兜底（如写成 https://goproxy.cn,https://proxy.golang.org），但需确保能连上 sum.golang.org，否则会报 checksum mismatch

如何验证代理是否生效

别只看 go env GOPROXY，要实际触发一次模块下载并观察行为：

• 删掉本地缓存：go clean -modcache
• 运行：go mod download github.com/spf13/cobra@v1.8.0
• 如果输出中出现 Fetching https://goproxy.cn/github.com/spf13/cobra/@v/v1.8.0.info，说明代理已生效
• 若仍看到 Fetching https://proxy.golang.org/...，检查是否被 shell 配置文件（如 ~/.zshrc）里的旧 export 覆盖，或 IDE 终端未重载环境变量

私有模块和 replace 场景下要注意什么

设置了 GOPROXY 后，replace 仍优先于代理，但私有仓库（如 GitHub 私库、GitLab）默认会被代理拒绝，必须显式排除：

export GOPROXY=https://goproxy.cn,direct
export GONOPROXY=git.internal.company.com,github.com/my-org/private-repo

• 它只控制「是否走代理」，不影响 go mod vendor 或 go build 的路径解析
• 如果私有模块用了 git+ssh 协议（如 git@github.com:org/repo.git），需确保 git 命令本身能访问（比如 SSH key 已配置）
• GONOSUMDB 要与 GONOPROXY 对齐，否则可能因 sum 校验失败退出：export GONOSUMDB=git.internal.company.com

# git  # go  # github  # golang  # proxy  # 环境变量  # gitlab  # 配置文件  # 网络问题  # 为什么  # 继承  # internal  # ide  # https  # ssh  # 这是  # 会报  # 就会  # 多个  # 用了  # 要注意  # 只看  # 不稳定  # 不走  # 因其 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： Android使用GridView实现日历的简单功能  百度输入法全感官ai怎么关 百度输入法全感官皮肤关闭  千库网官网入口推荐 千库网设计创意平台入口  Swift中循环语句中的转移语句 break 和 continue  Laravel如何实现多表关联模型定义_Laravel多对多关系及中间表数据存取【方法】  青岛网站建设如何选择本地服务器？  如何彻底卸载建站之星软件？  Laravel如何实现全文搜索功能？（Scout和Algolia示例）  网站制作软件免费下载安装,有哪些免费下载的软件网站？  制作公司内部网站有哪些,内网如何建网站？  JavaScript如何实现路由_前端路由原理是什么  lovemo网页版地址 lovemo官网手机登录  ,怎么在广州志愿者网站注册？  Laravel项目结构怎么组织_大型Laravel应用的最佳目录结构实践  活动邀请函制作网站有哪些,活动邀请函文案？  如何选择PHP开源工具快速搭建网站？  学生网站制作软件,一个12岁的学生写小说，应该去什么样的网站？  Laravel怎么返回JSON格式数据_Laravel API资源Response响应格式化【技巧】  Laravel怎么配置S3云存储驱动_Laravel集成阿里云OSS或AWS S3存储桶【教程】  昵图网官网入口 昵图网素材平台官方入口  简历在线制作网站免费版,如何创建个人简历？  如何在万网主机上快速搭建网站？  Win11怎么关闭透明效果_Windows11辅助功能视觉效果设置  如何在云主机上快速搭建网站？  三星、SK海力士获美批准：可向中国出口芯片制造设备  如何在香港免费服务器上快速搭建网站？  Laravel请求验证怎么写_Laravel Validator自定义表单验证规则教程  Laravel如何使用软删除（Soft Deletes）功能_Eloquent软删除与数据恢复方法  如何快速搭建高效WAP手机网站？  标准网站视频模板制作软件,现在有哪个网站的视频编辑素材最齐全的，背景音乐、音效等？  Laravel怎么判断请求类型_Laravel Request isMethod用法  微信推文制作网站有哪些,怎么做微信推文，急？  如何生成腾讯云建站专用兑换码？  Laravel怎么导出Excel文件_Laravel Excel插件使用教程  原生JS实现图片轮播切换效果  Laravel如何实现邮箱地址验证功能_Laravel邮件验证流程与配置  如何快速生成橙子建站落地页链接？  如何在IIS服务器上快速部署高效网站？  微信h5制作网站有哪些,免费微信H5页面制作工具？  如何快速查询网站的真实建站时间？  Laravel辅助函数有哪些_Laravel Helpers常用助手函数大全  百度输入法ai组件怎么删除 百度输入法ai组件移除工具  Laravel怎么使用artisan命令缓存配置和视图  EditPlus中的正则表达式 实战(4)  怎么制作一个起泡网,水泡粪全漏粪育肥舍冬季氨气超过25ppm，可以有哪些措施降低舍内氨气水平？  如何快速搭建自助建站会员专属系统？  Java遍历集合的三种方式  移动端手机网站制作软件,掌上时代，移动端网站的谷歌SEO该如何做？  Laravel怎么实现搜索高亮功能_Laravel结合Scout与Algolia全文检索【实战】  Laravel如何发送系统通知_Laravel Notifications实现多渠道消息通知