Go语言通过GOPRIVATE环境变量配置私有仓库域名，结合SSH或HTTPS+Token认证确保git可访问，再在go.mod中声明依赖即可完成私有模块管理。
Go 语言从 1.11 版本开始引入了模块（Module）机制，支持通过 go mod 管理依赖。当项目依赖私有仓库（如 GitHub 私有库、GitLab 自建仓库、企业内部 Git 服务等）时，需要正确配置才能拉取代码。以下是 Golang 访问私有仓库模块的完整管理方式。
配置私有仓库域名
Go 命令行工具默认只信任公开仓库。要让 Go 正确识别并拉取私有模块，需在环境变量中设置私有仓库的域名前缀。
GOPRIVATE 是关键环境变量，用于告诉 Go 哪些模块路径是私有的，不应通过公共代理下载，也不应发送给pkg.go.dev 等服务。常用设置：
export GOPRIVATE=git.company.com,github.com/your-org/private-repo- 支持通配符：
github.com/your-username/*
也可使用 GONOPROXY 和 GONOSUMDB 进一步控制代理和校验行为：
立即学习“go语言免费学习笔记（深入）”；
-
GONOPROXY=git.company.com：指定这些模块不走代理 -
GONOSUMDB=git.company.com：跳过校验 checksum 数据库（因为私有库不在公共 sum db 中）
认证方式：通过 SSH 或 HTTPS + Token
Go 模块拉取依赖本质是调用 git 命令，因此只要确保本地 git 能访问私有仓库即可。
使用 SSH（推荐）
- 生成 SSH 密钥并添加到 GitHub/GitLab/自建 Git 服务
- 确保
git clone git@github.com:your-org/private-module.git可以成功执行 - 模块导入使用 SSH 格式：
import "github.com/your-org/private-module v1.0.0"
~/.ssh/id_rsa 等密钥文件使用 HTTPS + Personal Access Token
- 适用于不能使用 SSH 的环境
- 创建 Token（GitHub: Settings → Developer settings → PAT）
- 配置 git 凭据：
git config --global credential.helper store # 然后执行一次 git clone https://token@github.com/your-org/private-module.git
~/.netrc）：machine github.com login your-token password x-oauth-basic
模块导入与版本管理
在 go.mod 中正常声明私有模块依赖：
module myprojectgo 1.21
require ( github.com/your-org/private-module v1.2.0 git.company.com/lib/common v0.1.5 )
Go 会按以下流程拉取：
- 检查 GOPRIVATE 是否匹配
- 使用 git 协议克隆仓库（SSH 或 HTTPS）
- 检出指定版本（tag 或 commit）
- 验证
go.sum（除非被 GONOSUMDB 排除）
若遇到版本不存在问题，可尝试：
- 确认 tag 名称存在且格式正确（如 v1.2.0）
- 清理缓存：
go clean -modcache - 重新下载：
go mod download
基本上就这些。只要确保 git 能访问、域名加入 GOPRIVATE、认证配置正确，Golang 就能顺利管理私有模块依赖。不复杂但容易忽略细节。
