GoLand安装后代理设置与依赖下载教程-Golang-PHP中文网

goland中设置的goproxy仅作用于ide内置terminal的子shell，不影响系统终端、ci或run/debug配置；全局生效需用go env -w设置goproxy、gonoproxy和gonosumdb，且三者值须一致，goproxy末尾必须含,direct，清华源需带结尾斜杠，验证须用go mod download -x观察真实请求。

goland安装后代理设置与依赖下载教程

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,direct
go 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

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 日志能暴露真实问题。