正确配置GOPRIVATE并确保VCS认证即可使用私有模块：1. 设置GOPRIVATE环境变量指定私有路径；2. 通过SSH或HTTPS+Token配置Git认证；3. 可选搭建Athens等私有代理缓存；4. 在go.mod中正常引用私有模块路径，版本支持tag、commit或分支。只要Git能访问，Go就能拉取。
在使用 Go 模块开发时，经常会遇到需要引入私有仓库的模块，比如公司内部 Git 服务器上的项目。Go 默认通过公共网络拉取模块，但私有模块无法直接访问，必须配置认证和路径映射。以下是 Golang 私有模块镜像的使用与管理方法。
配置私有模块路径
Go 工具链通过 module path 判断是否走代理或直连。对于私有模块，需告知 Go 哪些路径属于私有，不应通过公共代理（如 goproxy.io）拉取。
使用环境变量 GOPRIVATE 来指定私有模块前缀：
export GOPRIVATE=git.company.com,github.com/your-org/private-repo- 也可用
go env -w GOPRIVATE=...永久设置
设置了 GOPRIVATE 后，go get 不会通过 GOPROXY 获取这些模块，而是直接通过 VCS（如 git）拉取。
立即学习“go语言免费学习笔记（深入）”；
认证访问私有仓库
私有模块通常需要身份验证。常见方式包括 SSH 和 HTTPS + Token。
使用 SSH 方式（推荐）：
- 确保本地已生成 SSH 密钥并添加到 Git 服务器（如 GitLab、GitHub、Gitea）
- 模块导入路径使用 SSH 格式：
import "git.company.com/team/project" - Go 会自动调用 git，由 SSH agent 完成认证
使用 HTTPS + Token：
- 生成个人访问令牌（PAT），避免使用密码
- 配置 Git 凭据存储：
git config --global credential.helper store- 首次拉取时输入
https://TOKEN@github.com/your-org/private-module - 凭证将被保存，后续操作无需重复输入
私有镜像代理搭建（可选）
若团队规模较大，频繁拉取私有模块影响效率，可搭建私有模块代理缓存。
使用 Athens 或 JFrog Artifactory 等工具：
- 部署 Athens 作为模块缓存代理
- 配置
export GOPROXY=https://athens.company.com - 设置
GOPRIVATE排除不需要代理的路径 - Athens 可配置为只缓存公共模块，私有模块直连后端 Git
这种方式兼顾安全与性能，适合企业级 Go 开发环境。
go.mod 中的模块引用
私有模块的引用方式与公共模块一致，关键是路径要匹配仓库地址：
require git.company.com/team/lib v1.2.0- 版本可以是 tag、commit 或分支（如 v1.2.0, latest, v1.2.0-rc.1）
- 确保 git 仓库中打了对应 tag
如果模块未发布 tag，可用 go get git.company.com/team/lib@commit-hash 临时指定版本。
基本上就这些。核心是正确设置 GOPRIVATE 并保障 VCS 访问权限。只要 Git 能拉代码，Go 就能下载模块。不复杂但容易忽略细节。
