GoLand中设置的GOPROXY仅作用于IDE内置Terminal的子shell,不影响系统终端、CI或Run/Debug配置;全局生效需用go env -w设置GOPROXY、GONOPROXY和GONOSUMDB,且三者值须一致,GOPROXY末尾必须含,direct,清华源需带结尾斜杠,验证须用go mod download -x观察真实请求。

GoLand 里设的 GOPROXY 只影响 Terminal,不等于全局生效
GoLand Settings → Go → Go Modules → Environment 里填的 GOPROXY,只作用于 IDE 底部 Terminal 启动的子 shell。它不会覆盖你系统级的环境变量,也不会影响外部终端、CI 流水线或 go build 脚本。
新开一个系统终端执行 go env GOPROXY,输出很可能还是空或默认值 https://proxy.golang.org,direct。如果你用的是 WSL 或远程开发容器,IDE 终端和宿主机环境完全隔离,GOPROXY 必须在容器内单独配置。
真正生效的方式是用 go env -w 设置系统级变量:
go env -w GOPROXY=https://goproxy.cn,directgo env -w GONOPROXY="git.internal.company.com,github.com/my-org"go env -w GONOSUMDB="git.internal.company.com,github.com/my-org"
注意:GONOPROXY 和 GONOSUMDB 值必须完全一致,通配符(如 github.com/my-org/*)不支持,得逐个列出具体域名或仓库路径。
为什么填了 https://goproxy.cn 还是拉不到私有模块
常见错误是漏掉 ,direct。Go 的 fallback 是严格顺序匹配的:遇到第一个返回 HTTP 2xx 的地址就停;404、503、timeout 都算“不可用”,继续下一个。但如果没有 direct,私有模块(如 git.internal.company.com/lib)根本不会尝试直连,直接报 404 或 timeout。
清华源必须带结尾斜杠:https://mirrors.tuna.tsinghua.edu.cn/go/modules/,否则返回 404。
推荐组合写法:
https://mirrors.tuna.tsinghua.edu.cn/go/modules/,https://goproxy.cn,direct- 逗号前后不能有空格
验证代理是否真起作用,别信 go list -m all
go list -m all 成功不代表走代理——它可能从本地缓存读取。要触发真实网络请求,必须用 -x 参数观察日志流。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
运行:
go mod download -x github.com/gin-gonic/gin@v1.12.0
看输出里是否出现类似 GET https://goproxy.cn/github.com/gin-gonic/gin/@v/v1.12.0.info 的请求。如果看到 lookup git.internal.company.com 直连成功,说明 GONOPROXY 也生效了。
如果只看到 GET https://goproxy.cn/... 但私有模块失败,大概率是 GONOPROXY 没配或值不匹配。
GoLand 点 ▶️ 运行 main 不读 GOPROXY,除非手动勾选
GoLand 自带的 Run/Debug 配置(比如直接点 ▶️ 运行 main)默认不读取 Settings 里填的 GOPROXY 字段,除非你手动勾选 “Include system environment variables”。
更稳妥的做法是:在 Run → Edit Configurations → Environment variables 里显式加上 GOPROXY=https://goproxy.cn,direct,避免依赖 IDE 的继承逻辑。
另外,go mod tidy 在 IDE 右键菜单里触发有时跳过校验步骤。最稳操作是关掉所有 Terminal,重新开一个,cd 进项目根目录(确保有 go.mod),再敲 go mod tidy。
复杂点在于:代理生效 ≠ 下载成功。GOSUMDB 校验失败时,go build 会静默失败或卡住,而 GoLand 编辑器界面可能不报错——只有 go mod download -x 或 CI 日志能暴露真实问题。

















