配置GOPRIVATE跳过私有库校验，并通过SSH或Personal Access Token配置Git认证，使Go模块能自动拉取私有仓库代码，确保导入路径与版本标签符合规范。
在使用 Go 模块开发时，经常会遇到需要引入私有库的情况。这些私有库可能托管在 GitHub、GitLab、Gitee 或企业内部 Git 服务器上。为了让 go mod 正确拉取私有模块并进行权限控制，需结合环境变量、Git 配置和认证机制来实现。
配置 GOPRIVATE 跳过校验
Go 默认会对模块进行校验（如通过 proxy.golang.org），但私有库不应公开暴露。通过设置 GOPRIVATE 环境变量，可告诉 Go 命令哪些模块是私有的，无需走公共代理或校验 checksum。
示例：export GOPRIVATE="git.example.com,github.com/your-org/*"- 也可用 go env 设置：
go env -w GOPRIVATE=git.example.com
这样，git.example.com 下的所有模块将跳过代理和 checksum 校验。
使用 SSH 认证访问私有库
最常见的方式是通过 SSH 密钥对进行身份验证。确保你的开发机器已生成 SSH key，并将公钥添加到代码平台（如 GitHub/GitLab）的部署密钥或用户 SSH keys 中。
立即学习“go语言免费学习笔记（深入）”；
操作步骤：- 生成 SSH key：
ssh-keygen -t ed25519 -C "your@email.com" - 启动 ssh-agent 并加载密钥：
eval $(ssh-agent); ssh-add ~/.ssh/id_ed25519 - 测试连接：如 GitHub 可执行
ssh -T git@github.com
之后 Go 会自动使用 SSH 拉取模块，例如：
import "github.com/your-org/private-module.git"
使用 Personal Access Token (PAT) 配合 HTTPS
若使用 HTTPS 协议拉取私有库（如 CI/CD 环境中），推荐使用 Personal Access Token 替代密码进行认证。
以 GitHub 为例：
- 在 Settings → Developer settings → Personal access tokens 中创建 token，权限包含
repo - 配置 Git 凭据：
git config --global url."https://your-token@github.com".insteadOf "https://github.com"
或写入 ~/.netrc 文件（Linux/macOS）：
machine github.com login your-username password your-token
Windows 用户可使用 Git Credential Manager 存储凭据。
模块导入与 go.mod 示例
假设私有模块路径为 git.example.com/team/project/v2，在项目中直接引入：
import "git.example.com/team/project/v2"
运行 go mod tidy 时，Go 会尝试通过 Git 拉取该仓库的最新 tagged 版本。确保仓库的 tag 符合语义化版本规范（如 v2.0.1）。
module myapp
go 1.21
require (
git.example.com/team/project/v2 v2.0.1
)
基本上就这些。只要正确设置 GOPRIVATE 和 Git 认证方式，Go 就能顺利访问私有模块。关键在于让底层 Git 命令能无交互地完成 clone 和 fetch 操作。
