根本原因是goprivate域名匹配错误且goproxy未配置fallback链：goprivate需精确匹配模块路径前缀（如git.corp.com/**），不支持*.corp.com通配；goproxy必须为逗号分隔的多源链且以direct结尾，否则私有模块无法回退直连。
内网环境拉不到 Go 模块，根本不是“代理没开”，而是 GOPROXY 和 GOPRIVATE 的匹配逻辑没对上——域名通不通，取决于 Go 是否认为该模块“该走代理”。
为什么 git.corp.com/internal/pkg 会卡在 401/403 或 timeout
Go 不会自动把 git.corp.com 当作私有域名。它只看 GOPRIVATE 值是否匹配模块路径前缀。如果配置是 GOPRIVATE=*.corp.com，实际无效：Go 不支持域名通配符，* 只能用于路径段（如 git.corp.com/**）。
-
GOPRIVATE=git.corp.com/**→ 匹配git.corp.com/internal/pkg、git.corp.com/infra/log -
GOPRIVATE=git.corp.com/*→ 只匹配git.corp.com/pkg，不匹配嵌套路径 - 多个域名用英文逗号分隔：
GOPRIVATE=git.corp.com/**,gitee.com/my-team/* - 必须确保
GOPROXY末尾含direct，否则即使GOPRIVATE配对成功，Go 仍可能因 fallback 顺序错误尝试公网镜像
GOPROXY 必须是逗号分隔的 fallback 链，不能只写一个地址
单一值如 GOPROXY=https://goproxy.cn 在内网下极易失败：一旦 goproxy.cn 返回 404（比如请求的是公司私有路径），Go 不会自动跳到直连，而是直接报错。
- 正确写法：
GOPROXY=https://goproxy.cn,https://proxy.golang.org,direct - 逗号分隔，按顺序尝试；
direct必须在最后，表示“前面都失败就直连” - 不要用竖线（
|）：那是旧版 Go（ - 验证是否生效：
go env GOPROXY输出应完整显示逗号分隔的三段
私有 Git 服务返回 x509 错误？不是 Go 的问题，是 git 的 SSL 配置没对齐
GOPRIVATE 只控制代理和校验跳过，不控制 TLS 连接本身。Go 拉取私有模块时底层调用的是 git 命令，证书校验由 git 执行。
- 若用 HTTPS 协议，运行
git config --global http."https://git.corp.com/".sslCAInfo /etc/certs/corp-ca.crt - 若用 SSH 协议，确保
~/.ssh/id_rsa存在且git.corp.com在~/.ssh/known_hosts中 - 临时调试可用
GOINSECURE=git.corp.com，但仅限开发机，生产环境必须配 CA - 测试 git 是否通：
git ls-remote https://git.corp.com/internal/pkg.git，这步通了，Go 才可能通
VSCode 启动后 GOPROXY 为空？GUI 应用不读 shell 配置文件
macOS 和 Linux GUI 环境下，VSCode 图标启动不会加载 ~/.zshrc 或 ~/.bashrc，导致 go 命令行能用，但编辑器里 go mod tidy 报错。
- 最稳解法：终端中执行
code .启动 VSCode，继承当前 shell 环境变量 - 备选方案：在项目根目录下
.vscode/settings.json中硬编码："go.toolsEnvVars": { "GOPROXY": "https://goproxy.cn,direct" } - 注意：
go.toolsEnvVars只影响 VSCode 内部工具（如 gopls），不影响终端里手动运行的go mod download—— 那部分仍需系统级环境变量生效 - 检查状态栏右下角是否显示
Go (1.22.5)，若为Go (unknown)，说明 gopls 未启动，重装gopls并确认GOROOT正确
真正麻烦的不是配置项本身，而是这些变量之间的协作边界：Go 解析模块路径 → 查 GOPRIVATE 决定是否跳代理 → 查 GOPROXY fallback 链决定怎么连 → 连上了再交由 git 处理协议和证书。漏掉任意一环，都会表现为“域名不通”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
