配置Git认证并设置GOPRIVATE环境变量，使Go能通过SSH或Personal Access Token访问GitLab私有模块，确保go mod tidy正常拉取代码。
在 Golang 项目中使用 go mod 导入 GitLab 私有模块时，由于仓库是私有的，Go 默认无法通过 HTTPS 直接拉取代码。需要配置认证方式让 go get 能够访问私有仓库。以下是完整的解决方案。
1. 配置 Git 使用 SSH 或 Personal Access Token 访问私有仓库
Go modules 依赖底层的 Git 工具来拉取代码，因此必须确保 Git 可以访问你的 GitLab 私有仓库。有两种常见方式：
● 使用 SSH（推荐）
确保你已经在本地生成 SSH 密钥，并将公钥添加到 GitLab 账户中。
验证是否能通过 SSH 拉取仓库：
git clone git@gitlab.com:your-group/your-project.git
如果可以正常克隆，则 Go 在执行 go get 时也会使用 SSH 协议拉取模块。
立即学习“go语言免费学习笔记（深入）”；
● 使用 Personal Access Token（PAT）
如果你更倾向使用 HTTPS，需创建一个 Personal Access Token：
- 登录 GitLab → Preferences → Access Tokens
- 创建 token，权限至少包含
read_repository - 使用 token 替代密码进行认证
然后配置 Git 凭据：
git config --global url."https://oauth2:@gitlab.com".insteadOf "https://www.php.cn/link/ed2c74e394df9bcf67db4c5172c27f96"
替换后，所有对 https://www.php.cn/link/ed2c74e394df9bcf67db4c5172c27f96 的请求都会自动带上 token。
2. 设置 GOPRIVATE 环境变量
为了避免 Go 尝试通过公共代理（如 proxy.golang.org）下载私有模块，应设置 GOPRIVATE 环境变量，告诉 Go 哪些模块是私有的。
例如：
export GOPRIVATE=gitlab.com/your-group/*
这样，Go 就不会把这些模块发往公共代理，也不会做 checksum 校验检查。
也可以设置多个域名：
export GOPRIVATE=gitlab.com/your-group/*,internal.company.com
建议把这个变量加入 shell 配置文件（如 .zshrc 或 .bashrc），避免每次重新设置。
3. 在 go.mod 中引入私有模块
在项目中使用标准语法导入模块：
import "gitlab.com/your-group/your-module/pkg"
然后运行：
go mod tidy
Go 会尝试通过 Git 拉取该模块。只要 Git 配置正确且有权限，就能成功下载并缓存。
注意：模块路径必须与 GitLab 仓库路径一致，且仓库根目录下要有正确的 go.mod 文件。
4. CI/CD 环境中的处理（如 GitLab CI）
在 CI 环境中，通常没有交互式登录，需额外配置 SSH 或 Token。
● 方法一：使用 Deploy Token 或 CI Job Token
在 .gitlab-ci.yml 中配置：
before_script: - mkdir -p ~/.ssh - echo "Host gitlab.com" >> ~/.ssh/config - echo " StrictHostKeyChecking no" >> ~/.ssh/config - echo " IdentityFile ~/.ssh/id_rsa" >> ~/.ssh/config - chmod 600 ~/.ssh/config - ssh-keyscan gitlab.com >> ~/.ssh/known_hosts - echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add - - export GOPRIVATE=gitlab.com/your-group/*
其中 SSH_PRIVATE_KEY 是预先设置在 CI 变量中的私钥。
● 方法二：使用 CI Job Token（临时令牌）
git config --global url."https://gitlab-ci-token:$CI_JOB_TOKEN@gitlab.com".insteadOf "https://www.php.cn/link/ed2c74e394df9bcf67db4c5172c27f96"
这种方式无需上传密钥，安全性更高。
基本上就这些。只要 Git 能拉代码，Go mod 就能工作。关键是打通认证链路，再屏蔽代理即可。
