配置Golang私有仓库访问需三步：1.用SSH密钥或HTTPS+PAT认证Git；2.设置GOPRIVATE跳过代理和校验；3.自建服务需配置Git URL替换规则。
配置 Golang 私有仓库的访问权限，关键在于让 go 命令能够通过认证方式拉取私有模块。无论是使用 GitHub、GitLab、Gitee 还是自建 Git 服务，核心步骤都围绕 Git 协议和凭证管理展开。以下是具体设置方法。
1. 使用 SSH 配置私有仓库访问
如果你的私有仓库支持 SSH 协议，推荐使用 SSH 密钥进行认证，无需每次输入账号密码。
- 生成 SSH 密钥（若尚未生成）：
ssh-keygen -t ed25519 -C "your_email@example.com" - 将公钥（
~/.ssh/id_ed25519.pub）添加到你的代码平台（如 GitHub/GitLab）的 SSH Keys 设置中 - 测试连接：
ssh -T git@github.com（以 GitHub 为例） - 在
go.mod中使用 SSH 地址：module git@github.com:your-org/your-private-module
执行 go mod tidy 时，Git 会自动使用 SSH 密钥完成认证。
2. 使用 HTTPS + Personal Access Token (PAT)
部分环境限制 SSH 使用，可改用 HTTPS 配合令牌访问。
立即学习“go语言免费学习笔记（深入）”；
- 在代码平台创建个人访问令牌（Personal Access Token），赋予
repo权限 - 配置 Git 凭证存储：
git config --global credential.helper store - 首次克隆时使用令牌作为密码：
git clone https://github.com/your-org/your-private-module
用户名填你的账户名，密码填 PAT - 在
go.mod中使用 HTTPS 路径：module github.com/your-org/your-private-module
Go 工具链调用 Git 时会复用已保存的凭证。
3. 配置 GOPRIVATE 环境变量
避免 Go 尝试通过公共代理下载私有模块，必须设置 GOPRIVATE。
- 告知 Go 哪些模块路径是私有的：
export GOPRIVATE=github.com/your-org,git.yourcompany.com - 可配置多个域名，用逗号分隔
- 建议加入 shell 配置文件（如
~/.zshrc或~/.bashrc）避免重复设置
设置后，Go 不会对这些路径使用 proxy.golang.org 或执行 checksum 验证。
4. 自建 Git 服务器或特殊域名处理
若使用内部 Git 服务（如 git.internal.corp），还需额外配置 Git URL 转换规则。
- 配置 Git 替换协议：
git config --global url."git@git.internal.corp:".insteadOf "https://git.internal.corp/" - 确保
go.mod中引用路径与实际一致：module git.internal.corp/library/utils - 配合
GOPRIVATE=git.internal.corp使用
这样 Go 在请求模块时会自动转为可用的 SSH 地址拉取代码。
基本上就这些。只要凭证正确、协议通路畅通、GOPRIVATE 设置到位，Golang 就能顺利访问私有仓库。不复杂但容易忽略细节。
