GoLand中HTTPS私有仓库拉取失败的根本原因是Go工具链委托git执行时缺乏凭据，需配置git credential.helper并精确设置GOPRIVATE环境变量，二者缺一不可。
GoLand 里 HTTPS 私有仓库拉取失败，根本不是 IDE 的问题
GoLand 本身不处理模块下载逻辑，所有 go mod tidy、go get 行为都交给底层 Go 工具链执行，而 Go 工具链又把 Git 操作完全委托给系统 git 命令。所以你在 GoLand 点“Sync dependencies”报错，实际是 git clone https://git.example.com/internal/lib 失败——IDE 只是触发者，不是责任方。
常见错误现象包括：
fatal: could not read Username for 'https://git.example.com': terminal prompts disabled-
401 Unauthorized（尤其在 GitLab / Gitee / 自建 Gitea 上） go: module git.example.com/internal/lib@v0.1.0: reading git.example.com/internal/lib/go.mod at revision v0.1.0: 404 Not Found
这些都不是 GoLand 配置能修好的，必须从 Git 凭据层和 Go 环境变量两头入手。
HTTPS 场景下必须配 git config --global credential.helper
Go 调用 git 时不会读取 IDE 内置账号、也不转发系统 Keychain（除非你显式启用），默认会禁用交互式输入（terminal prompts disabled），所以必须让 git 自动提供凭据。
推荐做法（开发机适用）：
- 运行
git config --global credential.helper store（凭据明文存~/.git-credentials） - 首次执行
go get git.example.com/internal/lib时，终端会提示输入用户名 + 密码（或 Personal Access Token） - 之后所有
go mod操作自动复用，GoLand 同步也生效
注意：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- GitHub/GitLab 推荐用 PAT 替代密码，且 PAT 需勾选
read_package_registry或api权限 - 如果用的是自签名证书的内网 Git 服务，还需加
git config --global http."https://git.example.com/".sslVerify false（仅限可信内网） - 不要在
go.mod里写https://token:x-oauth-basic@git.example.com/...—— token 会随代码泄露
GOPRIVATE 必须精确匹配域名+端口，逗号分隔无空格
即使 git clone 能通，go mod 仍可能卡在 checksum 校验或 proxy 跳转上。这是因为 Go 默认把所有模块当公开源处理，会尝试走 GOPROXY 和 sum.golang.org，而私有仓库显然不在其中。
设置方式（以 macOS/Linux 为例）：
- 运行
go env -w GOPRIVATE=git.example.com,gitlab.internal:8443,*.company.dev - 注意：
*.company.dev匹配api.company.dev和git.company.dev，但不匹配company.dev（无子域） - 如果仓库地址含端口（如
https://git.example.com:8443/org/repo），GOPRIVATE必须带端口，写成git.example.com:8443，不能省略 - 多个域名严格用英文逗号分隔，禁止空格：✅
git.example.com,my.git❌git.example.com, my.git
验证是否生效：
- 运行
go env GOPRIVATE看输出 - 再跑
go list -m all，若不再报verifying ...: reading https://sum.golang.org/lookup/...就说明跳过成功
GoLand 同步前务必确认终端环境变量已加载
GoLand 启动时读取的是 shell 的初始环境（比如 ~/.zshrc 或 ~/.bash_profile），而不是你当前终端里临时 export 的变量。很多人在终端里 export GOPRIVATE=... 后测试成功，但 GoLand 里依然失败，就是因为 IDE 没读到。
解决办法：
- 把
go env -w GOPRIVATE=...加到 shell 配置文件末尾（推荐） - 或者在 GoLand → Preferences → Go → GOPATH 中，手动填入
GOPRIVATE值（但只影响该 IDE 实例，不通用） - 重启 GoLand（不是重载项目），让它重新加载 shell 环境
最容易被忽略的一点：GoLand 的 Terminal 默认复用 IDE 环境，但 Terminal 里新开的子 shell 可能又读取了旧配置。建议直接在 GoLand Terminal 里运行 go env GOPRIVATE 确认值正确，再执行 go mod tidy —— 这才是最贴近真实同步流程的验证方式。
