本文详解通过 git url 重写机制，让 `go get` 支持基于 ssh 地址（如 `git@1.2.3.4:group/repo.git`）的私有 gitlab 仓库，解决 go 原生不识别 ssh 格式导入路径的问题。
Go 的模块工具（包括 go get）默认仅支持以 https:// 或 git:// 开头的标准 URL 导入路径，而 GitLab 私有实例常提供形如 [email protected]:group/repo.git 的 SSH 地址——该格式虽被 git clone 原生支持，但 go get 会直接将其解析为无效的 Go 包路径（例如误判为 [email protected]/repo.git），从而报错 unrecognized import path。
根本解法是利用 Git 内置的 URL 重写（URL Rewriting） 功能：将 Go 工具链尝试发起的 HTTPS 请求，透明地重定向到等效的 SSH 地址。这无需修改代码、不依赖 GOPROXY，且兼容所有 Go 版本（经验证支持 Go 1.6.2 至 Go 1.22+）。
✅ 正确配置步骤
在终端执行以下命令（全局生效，推荐）：
git config --global url."git@1.2.3.4:".insteadOf "https://1.2.3.4/"
? 说明： 1.2.3.4 替换为你 GitLab 实例的实际 IP 或域名（如 gitlab.example.com）； git@1.2.3.4: 后必须带冒号 :，表示 SSH 协议前缀； insteadOf 表示「当 Git 遇到 https://1.2.3.4/... 时，自动替换为 git@1.2.3.4:...」。
配置生效后，即可正常使用标准 Go 工作流：
# 假设你的私有模块导入路径为：https://1.2.3.4/private-developers/project
# 在 go.mod 中声明：
module example.com/myapp
require (
gitlab.example.com/private-developers/project v0.1.0
)
# 执行拉取（go 会自动将 https://1.2.3.4/... 转为 git@1.2.3.4:...）
go mod tidy⚠️ 关键前提与注意事项
- SSH 访问已就绪：确保本地 ~/.ssh/id_rsa.pub 已添加至 GitLab 账户的 Deploy Keys 或 User SSH Keys，并能成功执行 ssh -T [email protected]；
- 避免混用协议：若 GitLab 同时开放 HTTP/HTTPS 端口，务必确认 go get 尝试访问的是你配置的 https://1.2.3.4/ 域名，而非 https://gitlab.example.com/（否则需另行配置对应 insteadOf）；
- 模块路径一致性：Go 模块的 module 声明（如 gitlab.example.com/group/repo）应与 GitLab 仓库的 Web 访问路径严格一致，Git 重写仅处理传输层协议，不改变逻辑路径；
-
调试技巧：启用 Git 详细日志可验证重写是否生效：
GIT_TRACE=1 go mod download gitlab.example.com/group/repo@v0.1.0
输出中若出现 url: expanding https://1.2.3.4/ → git@1.2.3.4:，即表示配置成功。
? 总结
Git 的 url.
