Go项目拉取私有仓库模块需配置三方面：一是Git凭据助手（如store或osxkeychain）自动提供token；二是设置GOPRIVATE环境变量（如git.example.com）使Go直连私有域名；三是go.mod中module路径须与Git仓库地址严格匹配（如git.example.com/team/project）。
Go 项目拉取私有仓库模块，核心在于让 go 命令能正确鉴权并访问你的私有 Git 服务（如 GitHub、GitLab、Gitee 或自建 Gitea/GitLab）。不需要改代码，关键是配置环境、凭证和 Go 模块代理行为。
配置 Git 凭据助手（推荐方式）
让 Git 自动提供用户名/密码或 token，避免每次拉取都手动输入：
- GitHub：运行
git config --global credential.helper store，首次克隆时输入 Personal Access Token（PAT）作为密码，之后自动复用 - GitLab：同样用
git config --global credential.helper store，用 Personal Access Token 登录 -
macOS 可用系统钥匙串：
git config --global credential.helper osxkeychain - Windows 推荐
git config --global credential.helper manager-core
设置 GOPRIVATE 环境变量
告诉 Go 不要通过公共代理（如 proxy.golang.org）去查私有模块，直接走 Git 协议：
- 例如私有模块域名是
git.example.com，执行：go env -w GOPRIVATE=git.example.com - 支持通配符：
go env -w GOPRIVATE=*.example.com,github.com/my-org/private-repo - 多个用逗号分隔，不加空格
- 确认生效：运行
go env GOPRIVATE
确保 go.mod 中模块路径匹配 Git 地址
Go 模块路径必须与 Git 仓库地址可映射，否则会报 unknown revision：
- 假设仓库地址是
https://git.example.com/team/project，则go.mod第一行应为：module git.example.com/team/project - 如果用了 SSH 地址（如
git@git.example.com:team/project.git），模块路径仍建议保持 HTTPS 风格（更通用），Go 会根据GOPRIVATE自动选择协议 - 避免用本地路径（如
./project）或模糊前缀（如myproject）作为 module 名
（可选）配置 GOPROXY 跳过私有域
如果你用了企业级 Go 代理（如 Athens、JFrog Artifactory），需确保它支持私有仓库或被绕过：
- 默认
GOPROXY是https://proxy.golang.org,direct，其中direct表示对GOPRIVATE中的域名直连 - 若自建代理，可设为：
go env -w GOPROXY="https://your-athens.example.com,direct" - 注意：不要把私有域名加进
GOPROXY列表，否则代理会尝试从公网拉取，失败
基本上就这些。重点就是三件事：Git 能登录、GOPRIVATE 告诉 Go 哪些是私有的、go.mod 的 module 路径跟 Git 地址对得上。不复杂但容易忽略某一项。
