根本原因是goprivate仅跳过代理与校验，不解决dns解析、认证或路径前缀匹配问题；必须确保域名可解析、git凭据有效、goprivate含通配符（如git.example.com/*）、gonosumdb同步设置且无环境变量覆盖。
为什么设置 GOPRIVATE 后 go mod tidy 仍报错 unrecognized import path
根本原因不是 GOPRIVATE 没生效，而是 Go 工具链在识别私有路径前就卡在 DNS 解析或认证环节。常见现象包括：unrecognized import path "git.internal.company.com/foo"、dial tcp: lookup git.internal.company.com: no such host 或 authentication required。
关键点在于：GOPRIVATE 只告诉 Go “跳过代理和校验”，但不解决“能不能连上”和“有没有权限”。必须同步确保：
- 本地能
ping git.internal.company.com或nslookup git.internal.company.com成功（否则是网络/DNS 问题） - Git 能凭当前凭证访问该地址：运行
git ls-remote https://git.internal.company.com/foo或git ls-remote git@git.internal.company.com:foo，确认返回 refs 列表 - 模块导入路径必须与 GOPRIVATE 中声明的前缀完全匹配——比如设置了
GOPRIVATE=git.internal.company.com，就不能用git.internal.company.com/foo/bar的子路径，而应写成git.internal.company.com/foo（除非加通配符git.internal.company.com/*）
如何正确设置 GOPRIVATE 值：通配符、多域名、斜杠边界
GOPRIVATE 的值不是正则表达式，而是以逗号分隔的“模块路径前缀列表”，匹配规则非常严格：只做字符串前缀比对，且不自动补斜杠。
错误配置示例：go env -w GOPRIVATE=git.internal.company.com —— 这会导致 git.internal.company.com/foo 匹配失败，因为 git.internal.company.com 不是 git.internal.company.com/foo 的前缀（缺结尾斜杠）。
正确做法：
- 用
*显式通配子路径：go env -w GOPRIVATE=git.internal.company.com/* - 多个域名用英文逗号分隔，**不能有空格**：
go env -w GOPRIVATE=git.internal.company.com/*,github.com/my-org/private-repo - 如果私有模块路径不含域名（如
mycompany/internal/util），直接写前缀：go env -w GOPRIVATE=mycompany/（注意结尾斜杠，否则mycompany/internal不匹配） - 避免过度宽泛：
GOPRIVATE=*是非法值；GOPRIVATE=.无效；必须是具体可解析的路径前缀
GOPRIVATE 和 GONOSUMDB 必须配对使用
设置 GOPRIVATE 后，Go 会跳过 GOPROXY，但仍默认连接 sum.golang.org 校验私有模块哈希——而私有模块没有公开校验记录，必然失败，报错类似：verifying git.internal.company.com/foo@v0.1.0: checksum mismatch 或 failed to load sumdb key。
解决方案不是关掉校验，而是明确告知 Go：“这些路径的模块不参与校验”：
-
go env -w GONOSUMDB=git.internal.company.com/*（值格式与 GOPRIVATE 完全一致） - 必须和 GOPRIVATE 设置相同的路径模式，否则校验仍会触发
- 不需要也不建议设
GOSUMDB=off，那会禁用所有模块校验，带来安全风险 - 验证是否生效：
go env GOPRIVATE GONOSUMDB应输出两行一致的路径列表
为什么 go env -w 设置后有时不生效
最常见原因是 Shell 环境变量覆盖了 go env 的持久配置。Go 读取环境变量的优先级是：OS 环境变量 > go env -w 写入的配置 > Go 默认值。
典型冲突场景：
- 你在
~/.zshrc里写了export GOPRIVATE=github.com/private，然后执行go env -w GOPRIVATE=git.internal.company.com/*—— 前者始终优先生效 - 终端未重载配置文件，导致新写的
go env -w在当前会话中不可见（需重启终端或source ~/.zshrc） - 某些 IDE（如 VS Code）启动时未继承 Shell 环境，需在 IDE 设置中显式指定 Go 环境变量
排查步骤：
- 运行
go env GOPRIVATE看输出，再运行echo $GOPRIVATE对比，若不一致，说明 OS 环境变量在干扰 - 临时清空干扰：
env -u GOPRIVATE go env GOPRIVATE，看是否输出预期值 - 彻底解决：删掉
~/.zshrc或~/.bash_profile中重复的export GOPRIVATE=...行，仅保留go env -w配置
