go mod download 不走 GOPROXY 而直连 GitHub，是因为 GOPROXY 配置含 direct 且代理未命中（如镜像未同步、路径不匹配或返回 404），触发 fallback 至 direct 模式；私有模块默认直连，需配合 GOPRIVATE 或自建代理支持。
go mod download 为什么有时不走 GOPROXY，而是直接连 GitHub？
因为 go mod download 默认行为是「按需拉取」，它只下载 go.mod 中显式声明的模块版本（含间接依赖），但不会主动解析和下载那些仅在 require 中存在、却未被当前构建路径实际引用的模块。更关键的是：是否走代理，完全由 GOPROXY 环境变量 + 模块路径匹配规则决定，而非命令本身。
常见错误现象：go mod download 报 404 Not Found 或卡在 git ls-remote，说明 Go 正绕过代理直连源站——通常是因为模块路径被 GOPROXY 列表中的 direct 或 off 触发了直连逻辑。
-
GOPROXY值为https://proxy.golang.org,direct时，只有当代理返回 404/410/500+ 才 fallback 到 direct（即走 git 协议） -
GOPROXY含https://goproxy.cn,direct，但该镜像尚未同步某私有模块或新 tag，就会退到direct，进而尝试git clone - 模块路径匹配失败：比如
example.com/internal/lib被GOPROXY规则判定为「非公开域名」，默认 fallback 到direct
如何让 go get / go mod download 强制走本地缓存或离线目录？
Go 没有内置“离线模式”，但可通过 GOMODCACHE + replace 组合实现本地寻址。核心思路是：让 Go 认为“这个模块已经存在且可信”，跳过远程校验与下载。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 手动把模块 zip 解压到
$GOMODCACHE/example.com@v1.2.3目录（注意命名必须严格匹配module@version格式） - 在
go.mod中加replace example.com => ./vendor/example.com，再运行go mod tidy—— 此时 Go 不会查网络，直接软链接该路径 - 若想全局生效（如 CI 离线环境），设
GOPROXY=off并确保所有依赖已预置进$GOMODCACHE；否则会报missing module
⚠️ 注意：replace 只影响构建时路径解析，不影响 go mod download 的行为；后者仍会尝试下载——除非你同时设 GOPROXY=off。
go list -m all 输出的路径，跟本地 $GOMODCACHE 中的目录名为什么经常不一致？
因为 Go 在本地存储时会对模块路径做「规范化处理」：去掉末尾 /vN、转义特殊字符、统一大小写，并附加哈希后缀。例如 golang.org/x/net 存为 golang.org/x/net@v0.23.0，而 github.com/gorilla/mux/v2 实际存为 github.com/gorilla/mux@v2.0.0+incompatible（因 v2 未用 Go Module 兼容规则发布）。
这直接影响你手动补包或调试时的路径拼写：
- 查真实路径用：
go list -m -f '{{.Dir}}' golang.org/x/net - 不要依赖
go mod graph输出的路径去$GOMODCACHE里找目录——它显示的是逻辑路径，不是物理路径 - Windows 下路径分隔符是
\，但$GOMODCACHE内部仍用/分隔，硬编码路径时容易出错
私有模块（如 gitlab.internal.com/group/repo）为什么总是 fallback 到 direct？
Go 从 1.13 起对私有域名有默认直连策略：只要模块路径不匹配 GOPROXY 中任意一个代理的「支持域名列表」，就自动 fallback 到 direct。这不是 bug，是设计使然——避免把内部地址误发给公网代理。
解决方法只有两个方向：
- 扩展
GOPROXY：比如设为https://proxy.golang.org,https://goproxy.cn,https://goproxy.yourcorp.com，并在自建代理中配置允许gitlab.internal.com域名 - 禁用自动 fallback：设
GOPROXY=https://goproxy.yourcorp.com（不含direct），此时若代理无法响应，会直接报错而非尝试 git
最容易被忽略的一点：Go 不会为私有模块生成 .mod 文件缓存校验和，除非你运行过 go mod download 且代理成功返回了 .info 和 .mod——这意味着首次拉取失败后，即使后续修复了代理，go build 仍可能反复重试，直到缓存命中。
