Go get 私有仓库：分步指南

Go get 私有仓库：为什么这对新手来说是个痛点？

您编写了一个很棒的 Go 包，将其上传到 GitHub 的私有仓库，现在想在另一个项目中使用它。您执行 go get github.com/yourname/secret-lib — 然后收到错误 403 Forbidden 或 remote: Repository not found。熟悉吗？

这种情况是 Go 初学者最常见的陷阱之一。Stack Overflow 上的问题“What's the proper way to "go get" a private repository?”已有数千次浏览。问题在于 go get 默认使用 HTTPS 而非 SSH，并且不知道您的凭据。

在本文中，我们将介绍 三种可行的方法 来配置 go get 以访问私有仓库：通过 .gitconfig、.netrc 和 GOPRIVATE 环境变量。您将了解如何避免错误并节省数小时的调试时间。

为什么 go get 无法与私有仓库一起使用？

默认情况下，go get 尝试通过 HTTPS 下载模块。对于公共仓库来说没问题——匿名访问是可行的。但私有仓库需要身份验证。Go 无法自动提供用户名/密码或令牌。

第二个问题是 模块发现机制。Go 首先通过分析 HTML 页面来检查仓库是否存在于 GitHub/GitLab/Bitbucket 上。对于私有仓库，未经授权无法访问该页面。因此会出现 repository not found 错误，尽管仓库确实存在。

方法 1：修改 ~/.gitconfig（最简单）

最简单的方法是强制 Git 对特定域名使用 SSH 而非 HTTPS。将以下行添加到 ~/.gitconfig 文件中：

[url "git@github.com:"]    insteadOf = https://github.com/

现在，对 https://github.com/ 的任何请求都将自动替换为 SSH。请确保您已配置 SSH 密钥并将其添加到 GitHub/GitLab 帐户。

验证：

go get github.com/your-org/private-repo# 运行无错误！

重要提示： 此方法会更改 GitHub 上 所有 仓库的行为。如果您只需要针对一个仓库，请使用更精确的配置：

[url "git@github.com:your-org/"]    insteadOf = https://github.com/your-org/

方法 2：使用 .netrc 管理令牌和密码

如果您更喜欢 HTTPS（例如在 CI/CD 中），请使用 ~/.netrc 文件。Go 能够读取此文件并自动填入凭据。

创建权限为 600 的 ~/.netrc 文件：

machine github.comlogin your-github-usernamepassword your-personal-access-token

如何获取令牌？ 在 GitHub 上：Settings → Developer settings → Personal access tokens → Generate new token。选择 repo 权限（用于私有仓库）。

之后：

go get github.com/your-org/private-repo

对于 GitLab：

machine gitlab.comlogin your-gitlab-usernamepassword your-gitlab-access-token

此方法非常适合 CI/CD，因为 SSH 密钥并不总是方便存储。

方法 3：GOPRIVATE — 模块的救生圈

GOPRIVATE 环境变量告诉 Go：“嘿，这些模块是私有的，不要尝试通过公共代理检查它们，也不要访问它们的 HTML 页面。”这解决了“repository not found”的问题。

在终端中设置（或将其添加到 ~/.bashrc / ~/.zshrc）：

export GOPRIVATE=github.com/your-org/*

现在，Go 将忽略您组织中所有仓库的公共模块代理（proxy.golang.org）。go get 命令将直接