混合网络下GOPROXY必须用逗号分隔多源fallback，单一值无法满足国内直连、内网私有模块绕过代理、golang.org/x类包走镜像三类需求；正确配置为GOPROXY=https://goproxy.cn,https://proxy.golang.org,direct，direct必须末尾且无协议前缀。
混合网络下 GOPROXY 必须用逗号分隔多源 fallback
单一 GOPROXY 值（比如只设 https://goproxy.cn）在混合云场景中必然失败：它无法同时满足「国内公有云模块直连」「公司内网 Git 私有模块绕过代理」「golang.org/x/ 类包走稳定镜像」三类需求。
正确配置是用逗号连接多个源，顺序即优先级：
-
GOPROXY=https://goproxy.cn,https://proxy.golang.org,direct—— 先试国内镜像，失败再试官方，最后 fallback 到直连 - 注意
direct必须写在末尾，且不带协议前缀；它不是 URL，而是 go tool 预定义关键字 - 若把
direct放前面，所有模块都直连，golang.org/x/net这类域名在国内大概率超时
GOPRIVATE 必须精确匹配私有 Git 域名，通配符不递归
设成 GOPRIVATE=*.corp.com 看似合理，但实际只匹配 git.corp.com 或 api.corp.com，不匹配 dev.git.corp.com（二级子域嵌套不被通配符覆盖）。
常见错误现象：go mod tidy 卡住并报 401/403，但 git clone https://dev.git.corp.com/internal/pkg 手动能通——说明是 go 工具层把请求转发给了镜像站，而非走 git 协议直连。
立即学习“go语言免费学习笔记（深入）”；
- 正确写法：
GOPRIVATE=git.corp.com,dev.git.corp.com,github.com/your-org/private-repo - 不要依赖
*覆盖所有子域；逐个列出实际用到的完整域名 - 确认生效：运行
go env GOPRIVATE，输出应为纯文本，不含空格或引号
go mod tidy 卡在 fetching dependencies 的真实断点在哪
不是网络慢，而是模块解析阶段触发了隐式 fetch：比如 go.mod 里没显式 require golang.org/x/net，但某个间接依赖（如 google.golang.org/grpc）内部 import 它，go 就会在解析时自动尝试拉取。
排查必须从命令行入手，VSCode GUI 界面看不到底层错误流：
- 先跑
go list -m all 2>&1 | grep -i "timeout\|404\|refused"，定位第一个失败模块 - 对失败模块单独试拉：
go get -v golang.org/x/net@latest，观察是卡在 DNS、TLS 握手，还是 401 返回 - 若返回 401 且域名含公司内网地址，立刻检查
GOPRIVATE是否漏配该域名
VSCode 中 go.mod 不自动更新，本质是环境变量未继承
GUI 启动的 VSCode（macOS 点图标 / Windows 开始菜单）默认不加载 shell 配置文件（如 ~/.zshrc），导致 GOPROXY 等变量为空。此时 go list 命令行能跑，但 VSCode 底部状态栏显示 Go (unknown)，go.mod 编辑无高亮、无自动补全。
- 临时解法：终端中执行
code .启动 VSCode，确保继承当前 shell 环境 - 长期解法：在项目根目录
.vscode/settings.json中硬编码："go.toolsEnvVars": { "GOPROXY": "https://goproxy.cn,direct", "GOPRIVATE": "git.corp.com" } - 注意：硬编码只影响 VSCode 内部工具链，
go mod download等终端命令仍依赖系统级环境变量，二者需一致
最易被忽略的一点：GOSUMDB 必须同步设为国内源。设成 sum.golang.google.cn 是底线，否则 go mod verify 阶段会因校验服务器不可达而阻塞整个流程，且错误提示极不明确——它不会说 “sum server timeout”，只会静默卡住或报 cryptic checksum mismatch。
