go get用ssh拉私有仓库失败的典型表现是报错“fatal: could not read username for 'https://...'”或卡住超时，根本原因是go默认走https且未配认证；必须同时满足三点：git配置ssh url重写、设置goprivate指定私有域、ssh密钥就位且权限正确。
go get 用 SSH 拉私有仓库失败的典型表现
执行 go get gitlab.example.com/team/project 报错：fatal: could not read Username for 'https://gitlab.example.com': No such device or address，或者直接卡住、超时。这不是 Go 的问题，而是底层 git 命令在尝试走 HTTPS 协议，但没配认证；而你本意是想走 SSH（git@gitlab.example.com:team/project）。Go 不会自动把 HTTPS URL 转成 SSH，也不会读取 ~/.ssh/config 或环境变量来改写地址。
让 go mod 正确走 SSH 的三步硬要求
必须同时满足以下三点，缺一不可：
- Git 配置中启用 SSH URL 重写：运行
git config --global url."git@gitlab.example.com:".insteadOf "https://gitlab.example.com/"（注意末尾斜杠和冒号） - Go 知道这个域名属于私有域：设置
GOPRIVATE=gitlab.example.com/**（**表示递归匹配所有子路径） - SSH 密钥已就位且可被
git使用：确保~/.ssh/id_rsa（或对应私钥）存在，权限为600，且公钥已添加到 Git 平台账号中
漏掉任意一条，go mod download 就会退回到 HTTPS 流程，然后因无凭据失败。
GOPRIVATE 和 GOINSECURE 的本质区别
GOPRIVATE 只是告诉 Go：“别走代理，直连”，它不改变协议、不提供认证，也不影响 git 的行为；而 GOINSECURE 是强制跳过 TLS 校验，只对 HTTPS 有效，对 SSH 完全无效。很多人误设 GOINSECURE=gitlab.example.com，结果毫无作用——因为 SSH 根本不走 TLS。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
真正起作用的是 Git 自己的配置和 SSH agent 状态。你可以手动验证：git ls-remote git@gitlab.example.com:team/project 成功，go mod download 才可能成功。
Windows 上容易忽略的 SSH 路径和权限问题
PowerShell 中设置 GOPRIVATE 要用：$env:GOPRIVATE="gitlab.example.com/**"（不能用 set GOPRIVATE=...）；更重要的是，Windows 默认 Git for Windows 使用 OpenSSH，但它默认不加载 ssh-agent，导致私钥无法自动选用。
解决办法：
- 启动
ssh-agent：在 PowerShell 中运行Get-Service ssh-agent | Set-Service -StartupType Manual; Start-Service ssh-agent - 添加私钥：
ssh-add ~/.ssh/id_rsa（注意路径用正斜杠或双反斜杠） - 确认
git能用：ssh -T git@gitlab.example.com应返回欢迎信息
没跑通这一步，go mod 就永远卡在“找不到凭据”上，而不是“证书错误”或“网络不通”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
