GoLand中私有仓库依赖拉不下来，主因是Go工具链未直连：需配GOPRIVATE跳过代理、Git认证（HTTPS凭据或SSH密钥）、必要时设GOINSECURE跳过证书校验，三者缺一不可。
GoLand 里私有仓库依赖拉不下来，基本不是 IDE 的问题，而是 Go 工具链根本没发起直连请求——它默认把 git.internal.company.com 当成公开模块，直接扔给 GOPROXY 去查，结果 404 或 timeout。必须手动配对 GOPRIVATE + Git 认证 +（必要时）证书绕过，缺一不可。
GoLand 界面设置的 GOPROXY 不影响私有模块直连
Settings → Go → Go Modules → Environment 里填的 GOPROXY，只作用于 IDE 底部 Terminal 启动的子 shell。它不会覆盖系统环境变量，也不影响 Run/Debug 按钮执行、CI 流水线或外部终端里的 go mod download。
- 新开一个系统终端执行
go env GOPROXY，输出很可能还是空或默认值 - Run/Debug 配置默认不读取该字段，除非你手动勾选 “Include system environment variables”
- 如果你用 WSL 或远程开发容器，IDE 终端和宿主机环境完全隔离，
GOPROXY必须在容器内单独配置
GOPRIVATE 必须设为 shell 环境变量才生效
GOPRIVATE 是 Go 工具链识别“哪些模块不走代理”的唯一开关，但 Go 命令不读 .env 或 IDE 界面字段，只认 shell 环境变量或 go env -w 写入的全局配置。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 开发机本地：写入
~/.zshrc或~/.bashrc，例如export GOPRIVATE=git.internal.company.com,github.com/my-org/*，然后source生效 - CI/CD（如 GitHub Actions）：必须在 job 的
env:块里显式声明，不能靠 runner 默认继承 - 匹配是左对齐精确前缀，
git.internal.company.com不匹配api.git.internal.company.com；要覆盖子域名，得写*.company.com或api.git.internal.company.com - 通配符
*必须显式带上，github.com/my-org无效，github.com/my-org/*才有效
私有模块拉取失败，90% 是 Git 层认证没通
GOPRIVATE 只解决“是否走代理”，不解决“Git 能否连上”。Go 底层调用的是 git clone，而它不读 IDE 凭据、不自动转发 SSH agent，完全依赖系统级 Git 配置。
- HTTPS 方式：运行
git config --global credential.helper store，首次拉取时输入 Personal Access Token（别用密码），之后go mod download自动复用 - SSH 方式：确保
git ls-remote git@git.internal.company.com:org/repo.git成功；模块路径必须是git@git.internal.company.com:org/repo格式，且~/.ssh/config中 Host 别名匹配 - 验证是否真通：手动执行等价命令
git ls-remote -q https://git.internal.company.com/org/repo.git refs/heads/main，看是否卡在 401 或 “Host key verification failed” - CI 中用 SSH：需注入
SSH_PRIVATE_KEY并ssh-add加载，私钥文件权限必须是600
自签名或过期证书导致 x509 错误，GOINSECURE 是唯一有效解
报 x509: certificate signed by unknown authority 或 x509: certificate has expired，不是 Go 配置错，是 net/http 和 git 命令都拒绝了未被信任的证书。InsecureSkipVerify 对 go 工具链无效，因为它底层调用的是 exec.Command("git", ...)。
-
GOINSECURE是 Go 1.13+ 引入的专用开关，仅对匹配GOPRIVATE的域名生效，跳过 TLS 校验（含过期、域名不匹配、未知 CA） - 写法严格：
export GOINSECURE=git.internal.company.com（不能带协议、端口、路径；多个用逗号分隔，无空格） - 必须与
GOPRIVATE配对使用，否则不触发 insecure mode - Git 自身仍需单独信任：运行
git config --global http."https://git.internal.company.com/".sslCAInfo /path/to/ca.crt
最常被忽略的点：你以为 go mod tidy 成功就万事大吉，但它可能从本地缓存读取。真正验证是否生效，必须用 go mod download -x 观察日志流——私有模块的 fetch URL 里绝不能出现 goproxy.cn 或其他代理地址，而应看到 git clone 或 GET https://git.internal.company.com/。
