GoLand配置私有Go模块拉取验证凭证-Golang-PHP中文网

goland中go get卡住或报401，根本原因是goprivate未精确配置且git凭证未生效：前者导致go仍走代理或校验，后者使https/ssh认证失败；二者缺一不可。

goland配置私有go模块拉取验证凭证

GoLand里go get卡住或报401，不是IDE问题，是凭证没透传过去

GoLand本身不管理Git凭证，它调用的是系统go命令，而go又依赖git拉代码。所以你在GoLand Terminal里go get git.example.com/team/lib失败，和IDE无关，只说明Git层没准备好认证。常见现象是命令卡在“Fetching”不动、终端无输出，或者突然报401 Unauthorized——这基本能锁定是HTTPS凭据缺失或SSH agent未加载。

必须同时配GOPRIVATE + Git credential.helper，缺一不可

GOPRIVATE只是告诉Go：“别走代理，别校验sum，直连”，但它不解决“怎么登录”的问题；Git凭据才是真正的钥匙。两者必须一起生效：

GoLand 2026.1.1

GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

下载

GOPRIVATE必须精确匹配模块路径前缀，比如模块是git.example.com/team/lib，就得设GOPRIVATE=git.example.com（不能写example.com，也不支持自动包含子域）
Git凭据推荐用store后端：运行git config --global credential.helper store，然后手动触发一次git clone https://git.example.com/team/lib.git，输入用户名（如git）和Personal Access Token（不是密码）
验证是否存进去了：查看~/.git-credentials，应有类似https://token:abc123@git.example.com的一行
之后在GoLand Terminal中执行go get git.example.com/team/lib@v1.0.0，就不会再卡住或弹401

用SSH比HTTPS更稳，但go.mod路径和~/.ssh/config必须对齐

如果公司启用了强制2FA，HTTPS方式容易失效，SSH是更可靠的选择——前提是路径和配置完全匹配：

模块路径必须是SSH格式：module git@example.com:org/repo，不能写成https://git.example.com/org/repo

~/.ssh/config里要定义Host别名，例如：

Host git.example.com
  User git
  IdentityFile ~/.ssh/id_rsa

运行ssh -T git@git.example.com确认能通，输出类似Hi username! You've successfully authenticated.
GoLand Terminal中执行go mod download时，会调用git clone git@example.com:org/repo.git，只要SSH连得上，就静默成功

GoLand Settings里GOPROXY填错会导致私有模块彻底失效

GoLand的Settings → Go → Go Modules → Proxy界面看似简单，但填错一个字符就会让私有模块拉取失败：

国内环境必须填https://goproxy.cn,direct，注意逗号后不能有空格，direct不能省——否则GoLand会把私有域名也发给goproxy.cn，而它不认识，返回404
如果公司有内网GitLab，且域名是git.internal，还要加进NO_PROXY环境变量（如export NO_PROXY="git.internal"），否则direct也绕不过代理
填完后务必在GoLand Terminal里运行go env GOPROXY确认输出一致；再跑go list -m all 2>/dev/null | grep internal看私有模块是否出现在列表里