GoLand无法图形化设置GONOPROXY/GONOSUMDB,二者必须通过go env -w或系统环境变量配置且值严格一致,否则私有模块将因校验失败或代理拦截导致下载中断。

GoLand 里根本没法直接填 GONOPROXY
GoLand 的 Settings → Go → Go Modules → Environment 界面只允许编辑 GOPROXY、GOSUMDB 这类变量,GONOPROXY 和 GONOSUMDB 不在下拉列表或输入框中。这不是 UI 缺失,而是 Go 官方设计如此:这两个变量必须通过 go env -w 或 shell 环境变量设置,IDE 不提供图形化入口。
GONOPROXY 必须和 GONOSUMDB 值一致
私有模块(比如 git.internal.company.com/mylib)如果只设 GONOPROXY 而漏掉 GONOSUMDB,Go 仍会尝试校验 checksum,结果是 verifying git.internal.company.com/mylib@v0.1.0: checksum mismatch 或直接 403。
-
GONOPROXY控制哪些域名不走代理(直连) -
GONOSUMDB控制哪些域名跳过校验(否则校验服务器找不到私有模块的 sum) - 两者值必须完全相同,例如:
go env -w GONOPROXY=git.internal.company.com; go env -w GONOSUMDB=git.internal.company.com - 多个域名用逗号分隔,不能有空格:
git.internal.company.com,github.company.net
验证是否生效得看 go mod download -x 的真实请求
别只信 go env GONOPROXY 输出,它可能显示正确,但实际请求仍发给了代理——因为 GOPROXY 配置错误或 fallback 顺序不对。
- 运行
go mod download -x github.com/gin-gonic/gin@v1.9.1:应看到请求发往https://goproxy.cn/... - 运行
go mod download -x git.internal.company.com/mylib@v0.2.0:应看到GET https://git.internal.company.com/mylib/@v/v0.2.0.info(直连),而不是GET https://goproxy.cn/... - 如果后者仍走代理,检查
GOPROXY是否写了direct,且位置在私有域名匹配之后(fallback 是顺序匹配)
Windows / WSL / 远程开发容器要分别配
GoLand 设置的环境变量只影响 IDE 自带 Terminal 启动的子 shell,不影响系统级命令、CI 流水线、外部终端,也不跨环境同步。
- Windows 用户:必须在「系统属性 → 环境变量」里添加
GONOPROXY和GONOSUMDB系统变量,再重启 GoLand - WSL 用户:在 WSL 的
~/.bashrc或~/.zshrc里加export GONOPROXY=...,然后在 GoLand 的 Terminal 里执行source ~/.zshrc或重启终端 - 远程开发容器:必须进容器内部运行
go env -w GONOPROXY=...,宿主机配置完全无效
真正容易被忽略的是 fallback 行为:Go 不会“智能判断”哪个域名该直连,它严格按 GOPROXY 列表顺序发起请求,直到第一个返回 2xx;而 GONOPROXY 只决定“跳过代理”,不决定“跳过校验”——GONOSUMDB 必须同步存在,否则校验阶段就卡死。











