混合网络下GOPROXY必须分层配置：GOPROXY设为逗号分隔的多源并fallback，GOPRIVATE显式豁免私有域名，GOSUMDB指定国内校验源；VSCode需终端启动或硬编码环境变量；私有模块401/403本质是git认证问题，须确保git命令能通。
混合网络下 GOPROXY 配置必须分层处理
国内直连失败、公司内网走代理、私有模块不走镜像——单一 GOPROXY 值无法覆盖全部场景。直接设成 https://goproxy.cn,direct 会导致私有仓库（如 git.corp.com/internal/pkg）被强制走公网镜像，404 或认证失败。
正确做法是用逗号分隔多个代理，并配合 GOPRIVATE 显式豁免：
-
GOPROXY=https://goproxy.cn,https://proxy.golang.org,direct：按顺序尝试，失败则 fallback -
GOPRIVATE=*.corp.com,github.com/your-org/private-repo：匹配到的域名跳过所有 proxy，直连 -
GOSUMDB=sum.golang.google.cn：国内可用的校验数据库，避免sum.golang.org超时
配置写入 ~/.zshrc 后执行 source ~/.zshrc，再用 go env GOPROXY GOPRIVATE GOSUMDB 确认三者都生效。
go mod tidy 卡在 fetching dependencies 的真实原因
不是网络慢，而是模块解析阶段触发了隐式代理请求——比如依赖里写了 golang.org/x/net，但 GOPROXY 没包含能响应它的镜像源，或 GOPRIVATE 漏配导致它被错误地转发到私有 Git 服务器。
立即学习“go语言免费学习笔记（深入）”；
排查步骤：
- 运行
go mod graph | head -20查看顶层依赖是否含golang.org/x/类路径 - 执行
go list -m all 2>&1 | grep -i "timeout\|refused\|404"定位具体失败模块 - 对失败模块手动试拉：
go get -v golang.org/x/net@latest，观察卡在哪一环
若确认是 golang.org/x/ 类包问题，把 https://goproxy.cn 放在 GOPROXY 第一位基本可解；若涉及公司内网 Git，必须确保 GOPRIVATE 精确匹配其域名（注意通配符不支持二级子域嵌套）。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
VSCode 中 go.mod 自动更新失效的常见诱因
不是插件没装，而是 VSCode 的 Go 扩展默认读取系统 shell 的环境变量，而 GUI 应用（如 VSCode）在 macOS 上可能不加载 ~/.zshrc，导致 GOPROXY 等变量为空。
解决方法：
- 终端中启动 VSCode：
code .，而非点击图标——这样继承当前 shell 环境 - 或在
.vscode/settings.json中硬编码："go.toolsEnvVars": { "GOPROXY": "https://goproxy.cn,direct" } - 检查状态栏右下角是否显示
Go (1.22.5)，若显示Go (unknown)，说明语言服务器未就绪，需重装gopls
注意：即使配置了 go.toolsEnvVars，仍需保证系统级 GOPROXY 存在，否则 go mod download 等命令行操作仍会失败。
私有模块拉取 401 或 403 时别只盯着 token
错误常被归因为 Git 凭据失效，但更隐蔽的问题是：Go 默认用 HTTPS 协议拉取，而某些企业 Git（如自建 Gitea）要求 SSH，或启用了双因子认证（2FA），HTTPS token 不被识别。
验证和修复方式：
- 先手动测试：
git ls-remote https://git.corp.com/internal/pkg.git，看是否返回 ref 列表 - 若失败，改用 SSH：
git config --global url."git@git.corp.com:".insteadOf "https://git.corp.com/" - 若必须用 HTTPS，确认 token 权限包含
read_repository，且未过期；部分平台（如 Bitbucket）还需开启App Password并绑定权限
Go 本身不处理 Git 认证逻辑，完全依赖 git 命令行为。只要 git clone 能通，go get 就能通——这是最容易被忽略的底层依赖关系。
