Git代理失效导致go mod download卡在clone阶段，根本原因是Go对非GOPROXY托管仓库（如SSH路径、私有库或GONOPROXY域名）会直接调用系统git命令，此时完全绕过GOPROXY，必须正确配置Git的http.proxy/https.proxy或SSH ProxyCommand；验证方式为GOPROXY=direct GONOPROXY="*" go mod download -v，若仍失败则100%是Git网络配置问题。

Git代理失效导致go mod download卡在clone阶段

Go模块下载失败，如果go mod download -v日志末尾反复出现git -c core.autocrlf=false clone且无后续响应，基本可判定是Git底层网络不通——不是GOPROXY问题，而是Git自身代理没配或配错。Go在拉取非模块代理托管的仓库（如私有GitLab、SSH路径、或未被GOPROXY缓存的github.com原始URL）时，会直接调用系统git命令，此时完全绕过GOPROXY。

• 检查当前Git是否启用代理：git config --get http.proxy 和 git config --get https.proxy；若为空，说明Git未配置代理
• HTTP(S)协议仓库需显式设代理：git config --global http.proxy http://127.0.0.1:7890（替换成你实际的代理地址）
• SSH协议仓库无法走HTTP代理，必须改用HTTPS URL或配置~/.ssh/config走SOCKS5跳转（见下一条）
• 若Git代理已设但仍失败，尝试加-v运行git clone -v https://github.com/xxx/yyy.git，观察具体卡在哪一步（DNS？TLS？认证？）

SSH仓库拉取失败：私有库+代理场景的典型断点

当go.mod里写的是git@github.com:my-org/private.git这类SSH路径，Go会调用git clone git@...，而SSH默认不读取http.proxy。此时即使GOPROXY和Git HTTP代理都配好了，依然会卡住或报Permission denied (publickey)。

• 最简方案：把go.mod中的SSH URL手动改成HTTPS格式，例如https://github.com/my-org/private.git，再配好Git HTTPS代理
• 保留SSH路径时，必须确保~/.ssh/id_rsa已添加到对应平台，并在~/.ssh/config中为该主机配置ProxyCommand：

  Host github.com
    ProxyCommand nc -X 5 -x 127.0.0.1:7891 %h %p

  （假设本地SOCKS5代理端口是7891）
• 验证SSH连通性：ssh -T git@github.com，成功应返回Hi xxx!；失败则说明密钥或代理链有问题

GOPROXY与Git代理的协作边界在哪里

GOPROXY只接管https://协议的模块索引和包文件下载（如https://goproxy.cn/github.com/user/repo/@v/v1.2.3.info），它对git clone行为零干预。这意味着：

GitHub操作助手

用大白话操作当前项目的 Git/GitHub——配置 GitHub（装 gh CLI + 登录 + 建仓库）、备份、拉取下载、查询历史、回滚代码、管理分支。当用户用日常语言表达 git 意图时触发（例如"git备份一下""git下载项目""git拉下来""git看看我改了啥""git回退到上一个版本""git新建个分支搞新功能""git合并到主分支""git

下载

• 所有以https://开头、且域名匹配GOPROXY支持范围的模块，由GOPROXY服务直接提供元数据和zip包，不触发Git命令
• 一旦模块路径是git@、ssh://、或https://但域名在GONOPROXY列表中，Go就会退回到调用git clone，此时Git自身的代理和凭证配置才起作用
• GONOPROXY和GOPRIVATE值必须一致；若漏配，Go会错误地把私有库请求发给GOPROXY，返回403后才 fallback 到git clone，徒增延迟

临时诊断：如何快速区分是GOPROXY问题还是Git问题

别猜，用两行命令分清责任方：

• 测试GOPROXY是否生效：GOPROXY=https://goproxy.cn,direct go list -m -u all 2>&1 | head -n 5。若看到大量https://goproxy.cn/... URL，说明代理链通；若看到Get "https://proxy.golang.org/..."，说明GOPROXY没生效
• 隔离Git行为：GOPROXY=direct GONOPROXY="*" go mod download -v。这强制所有模块都走git clone，如果此时成功，证明原问题是GOPROXY配置不当；如果仍失败，100%是Git代理或凭证问题
• 注意：某些私有GitLab实例返回的go-import meta tag 不规范，会导致Go误判协议类型，此时需手动在go.mod中用replace指定HTTPS路径

Git代理和GOPROXY是两条独立通道，各自失效时现象相似但根因完全不同。最容易被忽略的是：你以为在调用GOPROXY，其实Go早已悄悄切到了git clone——尤其当模块路径含SSH、或域名落在GONOPROXY里却没配Git代理时。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！