因为go默认代理proxy.golang.org在国内不可用且未缓存冷门项目，导致404或超时；需配置goproxy多镜像加direct、gosumdb国内镜像或off，并确保git协议转https、私有域名可解析、模块路径匹配。
为什么 go get 在国内经常卡在 proxy.golang.org 或直接 404？
因为 Go 默认模块代理 proxy.golang.org 在国内无法稳定访问，且部分冷门项目（比如托管在 GitLab、Codeberg、自建 Gitee 私仓或小众域名下的仓库）根本没被该代理缓存。你看到的 module github.com/xxx/yyy: reading https://proxy.golang.org/...: 404 Not Found 或超时，本质是代理链断了，不是你本地网络问题。
绕过代理直连时，git 协议和 https 协议怎么选？
Go 模块下载底层依赖 git 命令，而国内对 git:// 协议基本已屏蔽，必须强制走 https。但很多冷门项目只暴露了 git@xxx SSH 地址，或者 https 地址带认证前缀（如 https://token@codeberg.org/...），直接用会失败。
- 运行
git config --global url."https://".insteadOf git://，确保所有git://请求转成https:// - 对 SSH 地址（如
git@gitlab.com:user/repo.git），改写为https://gitlab.com/user/repo.git；注意去掉用户名密码段，否则go get会拒绝解析 - 若项目使用私有域名（如
https://gitee.example.com/group/proj），需确认该域名能被 DNS 解析且 HTTPS 可访问——curl -I https://gitee.example.com能返回 200 才算通
GO111MODULE=on + GOPROXY=direct 真的够用吗？
不够。设 GOPROXY=direct 是关闭代理，但 Go 仍会尝试从 https://sum.golang.org 校验 checksum，而这个地址在国内同样不可达，导致 verifying github.com/xxx/yyy@v1.2.3: checksum mismatch。
- 必须同时设置
GOSUMDB=off（禁用校验）或GOSUMDB=sum.golang.org+https://sum.golang.org→ 改为国内镜像（如GOSUMDB=sum.golang.org+https://goproxy.cn/sum，前提是该镜像支持 sumdb） - 更稳妥的做法：临时加
-mod=mod参数，跳过远程校验，例如go get -mod=mod github.com/xxx/yyy - 如果模块含
replace指向本地路径或非标准 URL，确保go.mod中的replace行协议一致（全部用https://，别混用file://或git@）
遇到 unknown revision 或 cannot find module providing package 怎么定位？
这不是网络问题，而是 Go 不知道该去哪里找那个模块——尤其当项目用了非标准 import path（比如 codeberg.org/user/repo）但仓库实际托管在 https://git.codeberg.org/user/repo，Go 默认不会自动补全域名。
- 先手动
git clone https://git.codeberg.org/user/repo.git到本地，再用go mod edit -replace codeberg.org/user/repo=./local/path显式替换 - 检查
go.mod第一行的 module path 是否与实际仓库根 URL 匹配；不匹配就改，比如模块声明是module example.com/foo，但代码实际在https://gitee.com/bar/foo，Go 就找不到 - 某些项目在
go.mod里写了github.com/xxx/yyy v0.0.0-00010101000000-000000000000这种伪版本，说明它没打 tag，此时必须指定 commit hash：go get github.com/xxx/yyy@abcd123
冷门项目往往缺乏标准化维护，模块路径、tag 规范、代理兼容性都是碎片化的。真正打通的关键不是换代理，而是理解 Go 如何解析 import path、何时触发 git 克隆、以及 checksum 和 sumdb 的校验时机——这些环节任何一处断掉，都会表现为“下载失败”。
