答案：Go依赖下载失败多因网络或代理配置问题，需正确设置GOPROXY和GOPRIVATE并排查连通性。国内用户应将GOPROXY设为清华源或阿里云镜像以加速模块下载，如https://mirrors.tuna.tsinghua.edu.cn/go/modules/或https://goproxy.cn；若项目引用私有仓库，必须通过GOPRIVATE排除对应域名，避免代理访问导致403错误；调试时可临时使用GOPROXY=direct绕过代理或添加-v参数查看详细拉取过程，结合curl测试代理连通性，定位timeout、module lookup failed等问题根源。常见错误如403多因GOPRIVATE未覆盖私有库，unknown revision则可能为拼写错误或权限问题，go mod tidy卡住常由间接依赖触发私有路径引起，可用go list -m all分析依赖链。核心是配对代理、标清私有域、用direct与日志快速诊断。
Go 依赖下载失败，多数时候不是代码问题，而是网络或代理配置没对。国内用户尤其常见：go get 卡住、timeout、403、module lookup failed，基本都和 GOPROXY、GOPRIVATE、网络连通性有关。
检查并设置正确的 GOPROXY
Go 1.13+ 默认启用了模块代理（GOPROXY），但默认值是 https://proxy.golang.org,direct，而这个地址在国内通常无法稳定访问。
- 推荐使用国内可信代理，例如清华源：
go env -w GOPROXY=https://mirrors.tuna.tsinghua.edu.cn/go/modules/ - 也支持多级 fallback，比如同时配清华 + 阿里云 + direct：
go env -w GOPROXY="https://mirrors.tuna.tsinghua.edu.cn/go/modules/,https://goproxy.cn,direct" - 验证是否生效：
go env GOPROXY 应该输出你刚设的值
区分私有模块：正确配置 GOPRIVATE
如果你的项目引用了公司内网 Git、GitHub 私有库或 GitLab 自建实例，Go 默认仍会尝试走代理，导致 403 或找不到模块。
- 把私有域名加进 GOPRIVATE，让 Go 跳过代理直连：
go env -w GOPRIVATE="git.example.com,github.com/my-org/private-repo" - 支持通配符，比如整个 GitHub 组织：
go env -w GOPRIVATE="github.com/my-org/*" - 多个用逗号分隔，注意不要加空格
临时绕过代理调试网络问题
当不确定是代理还是网络本身的问题，可以快速切换模式验证：
立即学习“go语言免费学习笔记（深入）”；
- 临时关闭代理（仅本次命令生效）：
GOPROXY=direct go mod download - 临时指定代理（不改全局）：
GOPROXY=https://goproxy.cn go mod download - 加上 -v 参数看详细过程：
go mod download -v 可看到每个模块从哪个 URL 拉取、是否重定向、状态码等
常见错误与对应解法
遇到具体报错时，别急着重装 Go，先对号入座：
- “connection refused” / “timeout” → 检查 GOPROXY 是否可用，或执行 curl -I https://goproxy.cn 测试连通性
- “403 Forbidden” → 多因 GOPRIVATE 没配全，私有仓库被代理转发；也可能是代理服务端限流（如 proxy.golang.org 对国内 IP 不友好）
- “unknown revision” / “module not found” → 模块名拼写错误，或仓库已删/权限变更；可手动访问 https://goproxy.cn/github.com/user/repo/@v/list 看是否存在
- go mod tidy 卡住不动 → 很可能是某个间接依赖触发了未配 GOPRIVATE 的私有路径，用 go list -m all 查出可疑模块再针对性处理
基本上就这些。核心就三点：代理选对、私有域标清、出错时用 direct + -v 快速定位。不复杂但容易忽略。
