官方proxy.golang.org无法拉取公司内网模块、不支持鉴权审计与缓存定制，且忽略replace/exclude指令导致构建失败，故必须部署私有代理（如goproxy或Athens）并正确配置GOPRIVATE、GOINSECURE及ALLOWED_HOSTS。
为什么直接用 go proxy 官方服务不满足私有需求
官方 proxy.golang.org 无法拉取公司内网模块（如 git.internal.company.com/myteam/lib），也不支持鉴权、审计、缓存策略定制。更关键的是，它默认不保留 replace 或 exclude 的语义——私有代理必须原样透传这些指令，否则 go build 会失败。
常见错误现象：go get 报 module not found，或拉到错误版本（比如把 replace github.com/foo/bar => ./local 忽略后去公网找）。
- 私有模块路径必须可被
go mod download解析为合法 module path（不能含非法字符，建议统一用小写+短横线） - 代理需识别
GOINSECURE环境变量并跳过 TLS 验证，否则自签名内网 Git 仓库会失败 - 若使用
go 1.21+，注意GOPRIVATE支持通配符（如*.internal.company.com），但代理本身仍需按字面匹配前缀
用 athens 还是手写 goproxy 服务
athens 功能全但重，启动即带 Redis/DB 依赖，调试时日志分散；goproxy（GitHub 上那个轻量 Go 实现）零外部依赖、单二进制、配置即生效，更适合快速落地。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 从
goproxyv0.15.0+ 开始，它原生支持replace和exclude的代理透传，无需 patch - 配置文件里用
UPSTREAM指向https://proxy.golang.org，再用PROXY_CACHE_ROOT指定本地缓存路径（如/var/cache/goproxy） - 必须设置
GOPROXY=direct在 Athens 启动前——否则它会把自己当成上游再循环代理 - 若要支持私有 Git 仓库，得在
goproxy配置中显式加ALLOWED_HOSTS，例如git.internal.company.com
go env -w 怎么配才不和 CI/CD 冲突
全局设 GOPROXY 很危险：CI 流水线可能跑在离线环境，或需要走不同代理。正确做法是分场景控制。
推荐方案：
- 开发机：用
go env -w GOPROXY=https://goproxy.internal.company.com,direct（末尾direct是 fallback，避免代理宕机时完全卡死） - CI 脚本开头加
export GOPROXY=https://goproxy.internal.company.com，不写direct——失败就该立刻报错，而不是悄悄 fallback 到公网 - 临时调试某模块？直接
GO_PROXY=https://goproxy.internal.company.com go list -m all，避免污染环境变量 - 绝对不要在
.bashrc里硬编码go env -w，它会写入go env的配置文件，导致团队成员 clone 后自动继承错误配置
模块校验失败（checksum mismatch）怎么定位
不是代理本身问题，而是 go.sum 里的哈希值和代理返回的模块内容不一致。根源通常是：私有模块打了 tag 但没推 git 的对应 commit，或 go mod tidy 时用了本地 replace 而没清理干净。
排查步骤：
- 用
curl -v https://goproxy.internal.company.com/github.com/myorg/pkg/@v/v1.2.3.info看返回的Version和Time是否匹配 tag commit - 对比
go mod download -json github.com/myorg/pkg@v1.2.3输出的Sum和本地go.sum里同一行是否一致 - 如果代理返回的
.zip文件解压后多出.git目录或 IDE 配置文件，说明打包脚本没 clean ——goproxy默认只取git archive输出，但 Athens 若配置了VCS模式则可能拉整个工作区
最易被忽略的一点：私有模块的 go.mod 文件里 module 声明必须和实际访问路径完全一致（包括大小写），哪怕 Git 仓库名是 MyLib，module 行也得写成 module mylib.internal.company.com。Go 不做大小写归一化，代理也不会帮你改。
