goland中goproxy仅在ide终端生效，全局生效需配置shell环境变量并设gonoproxy/gonosumdb；必须含direct且多镜像兜底，验证用go mod download -x。
GoLand里设GOPROXY不生效？因为只改了IDE终端环境
GoLand 的 Settings → Go → Go Modules → Environment 里填的 GOPROXY，只影响 IDE 底部 Terminal 启动的子 shell，不影响外部终端、CI 流水线、Run/Debug 配置（除非手动勾选 “Include system environment variables”）。新开系统终端执行 go env GOPROXY，大概率还是空或默认值。
真正生效的方式是全局设置：
- 在 shell 配置文件（如
~/.zshrc或~/.bash_profile）中添加：export GOPROXY=https://goproxy.cn,direct - 执行
source ~/.zshrc使配置生效 - 验证：
go env GOPROXY输出应为https://goproxy.cn,direct
注意：逗号前后不能有空格；direct 必须放在末尾，否则私有模块不会 fallback 到直连。
为什么只填https://goproxy.cn还超时或404？
Go 的代理 fallback 是严格顺序匹配的：遇到第一个返回 HTTP 2xx 的地址就停；404、503、timeout 都算“不可用”，继续下一个。但如果没有 direct，私有域名（如 git.internal.company.com）根本不会尝试直连，直接报错。
典型错误现象包括：
go: downloading github.com/some/pkg@v1.2.3: reading https://goproxy.cn/github.com/some/pkg/@v/v1.2.3.info: 404 Not FoundGet https://sum.golang.org/lookup/xxx: dial tcp 216.58.200.49:443: i/o timeout
正确写法必须带 direct 且多镜像兜底：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
export GOPROXY=https://mirrors.tuna.tsinghua.edu.cn/go/modules/,https://goproxy.cn,direct- 清华源必须带结尾斜杠，否则返回 404
- 单个镜像风险高：CDN 缓存未命中、证书更新、上游同步延迟都会导致 404，且无 fallback
私有模块拉不到？GONOPROXY和GONOSUMDB必须同步设
GoLand 界面里没有地方填 GONOPROXY 或 GONOSUMDB，它们只能通过 go env -w 设置。如果只设了 GOPROXY，Go 仍会把私有域名发给代理，结果就是 403、lookup failed 或 unknown revision。
必须成对设置：
go env -w GONOPROXY="git.internal.company.com,github.com/my-org"go env -w GONOSUMDB="git.internal.company.com,github.com/my-org"
注意：
-
GONOSUMDB值必须与GONOPROXY完全一致，否则校验失败导致下载中断 - 通配符不支持：
github.com/my-org/*无效，得展开写具体域名或仓库路径 - 若用 GitHub 私有仓库，还需加
go env -w GOPRIVATE=github.com/my-org
怎么确认代理真起作用？别信 go list -m all
go list -m all 可能从本地缓存读取，完全不走网络。要触发真实请求并观察日志流，唯一可靠方式是：
- 运行
go mod download -x，看输出中是否出现你配置的镜像域名（如goproxy.cn） - 若仍看到
proxy.golang.org或卡在sum.golang.org，说明GOPROXY或GOSUMDB没生效 - 国内必须同步设
GOSUMDB=gosum.io+ce6e7565+https://goproxy.cn/sumdb，URL 须与GOPROXY同源，否则报checksum mismatch
容易被忽略的一点：Go 1.21+ 默认 GOPROXY=https://proxy.golang.org,direct，但 proxy.golang.org 在国内访问极不稳定，且它不支持对 404 的 fallback —— 这意味着只要镜像没同步到某个版本，命令就直接失败，根本不会走到 direct。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
