Go工具链拉取私有模块需配置GOPRIVATE环境变量跳过代理与校验，并设置Git HTTPS凭据（如.netrc）或SSH认证（如insteadOf映射），确保域名匹配且权限正确。
要让 Go 工具链（如 go get、go mod tidy）正常拉取私有仓库的模块，关键在于两件事：告诉 Go 哪些域名属于私有模块（跳过代理和校验），以及提供对应仓库的认证凭据。核心配置是 GOPRIVATE 环境变量和 Git 凭据管理。
设置 GOPRIVATE 跳过代理与校验
Go 默认会对所有模块走公共代理（如 proxy.golang.org）并验证 checksums。私有仓库不在公共索引中，且通常不支持 checksum API，必须显式声明为“私有”。
- 在 shell 中设置（临时）：
export GOPRIVATE="git.example.com,github.company.com" - 推荐写入 shell 配置文件（如
~/.zshrc或~/.bashrc）并重载：echo 'export GOPRIVATE="git.example.com,github.company.com"' >> ~/.zshrc && source ~/.zshrc - 支持通配符，例如
GOPRIVATE="*.example.com"匹配所有子域名 - 多个域名用英文逗号分隔，**不能有空格**
配置 Git 认证方式（HTTPS 场景）
若私有模块地址是 HTTPS（如 https://git.example.com/org/repo），Go 依赖 Git 自身的凭据系统。常见方式有：
-
使用 git-credential-store 或 git-credential-cache：
运行git config --global credential.helper store，然后首次执行git clone https://git.example.com/org/repo，输入用户名密码后会被保存 -
使用 .netrc 文件（简单直接）：
在用户主目录创建~/.netrc，内容如下：machine git.example.com
login your-username
password your-personal-token
注意权限：运行chmod 600 ~/.netrc - GitHub/GitLab 推荐用 Personal Access Token（PAT）代替密码，尤其启用 2FA 后密码不可用
配置 SSH 认证（推荐用于企业内网）
若模块地址是 SSH 格式（如 git@git.example.com:org/repo.git），需确保：
立即学习“go语言免费学习笔记（深入）”；
- 本地已生成 SSH 密钥（
ssh-keygen -t ed25519），且公钥已添加到 Git 服务器账户 - Git 配置中将私有域名映射到 SSH URL：
git config --global url."git@git.example.com:".insteadOf "https://git.example.com/" - Go 模块路径仍可写成
git.example.com/org/repo，Go 会自动按 Git 配置转为 SSH 协议拉取
验证配置是否生效
执行以下命令检查当前环境与行为：
-
go env GOPRIVATE—— 确认值已正确设置 -
go list -m -u all或go mod tidy—— 观察是否成功拉取私有模块，无401 Unauthorized或module not found错误 -
git ls-remote https://git.example.com/org/repo.git—— 手动测试 Git 是否能访问（验证凭据）
不复杂但容易忽略的是：GOPRIVATE 必须覆盖完整模块路径的域名部分，且 Git 凭据必须对应该域名的实际请求协议（HTTPS 或 SSH）。配置完成后，日常开发中 go get 和 go build 就能透明使用私有模块了。
