配置GOPRIVATE并设置Git认证可使Go Modules拉取私有仓库，推荐使用SSH或PAT认证，确保git能访问仓库，必要时搭建私有代理服务。
Go Modules 是 Go 语言官方推荐的依赖管理方式，从 Go 1.11 开始支持。在实际开发中，我们经常需要引入私有仓库（如 GitHub、GitLab、Gitee 的私有项目）作为模块依赖。本文将详细说明如何配置 Go Modules 支持私有仓库，并完成私有模块的环境搭建。
配置 GOPRIVATE 跳过校验
默认情况下，Go 会尝试通过公共代理（如 proxy.golang.org）下载模块，并对模块进行 checksum 校验。对于私有仓库，这些操作会导致拉取失败。你需要通过 GOPRIVATE 环境变量告诉 Go 哪些模块是私有的，无需通过代理和校验。
设置方法：
go env -w GOPRIVATE=git.yourcompany.com,github.com/yourname/private-repo你也可以使用通配符：
立即学习“go语言免费学习笔记（深入）”；
go env -w GOPRIVATE=*.yourcompany.com,github.com/yourname/*该配置确保 Go 直接通过 git 协议拉取代码，跳过代理和 checksum 检查。
配置 Git 凭据访问私有仓库
Go Modules 使用 git 命令拉取代码，因此必须确保本地 git 能够认证并访问私有仓库。常用方式有 SSH 和 Personal Access Token（PAT）两种。
使用 SSH 方式（推荐）：
- 生成 SSH 密钥：ssh-keygen -t ed25519 -C "your-email@example.com"
- 将公钥（~/.ssh/id_ed25519.pub）添加到你的代码平台（GitHub/GitLab/Gitee）账户中
- 测试连接：ssh -T git@github.com
- 模块引用使用 SSH 地址：github.com/yourname/private-module v1.0.0
使用 HTTPS + Token：
- 创建 Personal Access Token（权限需包含 repo）
- 配置 git 凭据存储：
下次执行 git pull 时输入用户名和 token，凭据将被保存。
模块导入路径使用 HTTPS 格式即可。
验证私有模块引用
在 go.mod 中直接 require 私有模块：
require github.com/yourname/private-module v1.0.0执行命令触发拉取：
go mod tidy如果提示认证失败，请检查：
- GOPRIVATE 是否包含模块域名
- SSH 是否配置正确或 Token 是否有效
- git 是否能手动 clone 该仓库
企业级私有模块服务（可选）
对于团队协作，可以搭建私有 Go Module 服务：
- 使用 Athens Proxy：部署私有模块缓存代理，支持鉴权和审计
- 自建版本控制平台：GitLab 自带 Go Proxy 支持（启用了的话）
- 配置 GOSUMDB=off（仅限内部可信网络）
这类方案适合大型组织统一管理依赖源和安全策略。
基本上就这些。只要设置好 GOPRIVATE 并确保 git 认证可用，Go Modules 就能顺利拉取私有模块。不复杂但容易忽略细节。建议团队内部统一规范模块路径和认证方式，避免协作问题。
