答案：Go私有模块认证需配置GOPRIVATE环境变量并结合Git认证（SSH或HTTPS+PAT），通过go.mod正常声明模块路径，由Git凭证和环境变量协同完成拉取。

在使用私有仓库的 Go 模块时，Go 命令无法直接访问受保护的代码库。你需要配置凭证让 go mod 能够拉取私有模块。以下是几种常见的 Golang 私有模块认证方式，以及如何在 go.mod 和环境配置中正确设置。

1. 使用 GOPRIVATE 忽略校验并启用私有拉取

Go 工具链通过 GOPRIVATE 环境变量识别哪些模块是私有的，从而跳过校验（如 checksum 数据库）并允许使用自定义源拉取代码。

设置示例：

export GOPRIVATE=git.company.com,github.com/your-org/private-repo

你也可以在命令行中临时设置：

立即学习“go语言免费学习笔记（深入）”；

go env -w GOPRIVATE=git.company.com,*.internal.example.com

这个配置告诉 Go：所有匹配这些域名的模块都属于私有模块，不需要走公共代理或校验透明日志。

2. 配置 Git 凭证管理器（推荐用于 SSH 或 HTTPS）

Go 拉取模块底层依赖 Git，因此你需要确保 Git 能访问私有仓库。有两种主流方式：

使用 SSH（推荐）

• 生成 SSH 密钥并添加到你的代码平台（GitHub、GitLab、Gitea 等）
• 确保 ~/.ssh/config 正确配置主机别名和密钥路径
• 模块路径使用 SSH 格式：

import "git.company.com/team/project"

只要 SSH 可以 clone，go mod tidy 就能工作。

使用 HTTPS + 凭证助手

• 适用于 GitHub/GitLab 等支持 Personal Access Token (PAT) 的平台
• 配置 Git 使用凭证存储：

git config --global credential.helper store

第一次执行 go mod tidy 时会提示输入用户名和 PAT（密码），之后会被保存。

从 Git 仓库历史中彻底删除文件

|Git删除了文件，但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息（密码、密钥、token、私钥） - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件

下载

URL 示例：

https://gitlab.com/your-team/private-module.git

3. 使用 GONOSUMDB 跳过校验（可选）

除了 GOPRIVATE，你还可以单独控制哪些模块不进行 checksum 校验：

go env -w GONOSUMDB=git.company.com

通常 GOPRIVATE 已包含此功能，无需重复设置。

4. 在 go.mod 中声明模块路径（无需加凭证）

go.mod 文件本身不需要写入用户名或密码。只需正常声明模块导入：

require git.company.com/team/utils v1.0.0

凭证由 Git 和环境变量处理，不是 go.mod 的职责。硬编码凭证在任何地方都是禁止的。

5. 使用本地替换（仅限开发调试）

如果你在本地开发私有模块，可用 replace 临时指向本地路径：

replace git.company.com/team/utils => ../utils

发布前记得删除 replace，否则影响构建一致性。

基本上就这些。核心是：Go 不在 go.mod 中存凭证，而是靠环境（GOPRIVATE）+ Git 认证（SSH/PAT）协同完成私有模块拉取。配置清晰后，go mod tidy 和构建流程就能自动工作。