配置私有模块需设置GOPRIVATE、确保Git认证（SSH或Token）、正确引用模块路径并避免replace残留。
在 Golang 项目中使用私有模块，关键在于正确配置 go env 中的代理和私有仓库访问方式。Go 默认通过公共代理（如 proxy.golang.org）拉取模块，但私有仓库需要绕过代理或配置专用源。
1. 设置 GOPRIVATE 环境变量
GOPRIVATE 告诉 Go 哪些模块是私有的，不应通过公共代理下载，也不进行校验。适用于公司内部 Git 仓库。
设置方式：
立即学习“go语言免费学习笔记（深入）”；
- Linux/macOS：
export GOPRIVATE=git.yourcompany.com,github.com/yourorg/private-repo - Windows（PowerShell）：
$env:GOPRIVATE = "git.yourcompany.com,github.com/yourorg/private-repo"
也可使用通配符，如：export GOPRIVATE="*.yourcompany.com,*.internal"
2. 配置 Git 认证方式
Go 使用 git 命令拉取模块，因此需确保 Git 能访问私有仓库。推荐使用 SSH 或 Personal Access Token（PAT）。
使用 SSH：
- 生成并添加 SSH Key 到 Git 服务器（如 GitHub、GitLab、自建 GitLab）
- 模块导入路径使用 SSH 格式：
import "git.yourcompany.com/team/project" - 确保
~/.gitconfig中无错误重写规则
使用 HTTPS + Token：
- 生成 Personal Access Token（权限：read_repo）
- 配置 Git 凭据存储：
git config --global credential.helper store # 克隆一次私有模块，输入用户名和 token go get git.yourcompany.com/team/project # 或手动添加到 ~/.git-credentials： # https://token@yourcompany.com
3. go.mod 中正确引用私有模块
模块路径必须与 Git 仓库路径一致，否则会报错 module mismatch。
示例：
// go.mod module myappgo 1.21
require ( git.yourcompany.com/team/utils v1.0.0 )
首次拉取时运行：
go mod tidy
若本地已开发模块，可临时用 replace 指向本地路径：
replace git.yourcompany.com/team/utils => ./local/utils
上线前移除 replace，确保走真实版本。
4. 自建模块代理（可选）
企业环境中可部署 Athens 或 goproxy.io 私有实例，统一缓存和鉴权。
设置：
go env -w GOPROXY=https://proxy.yourcompany.com,direct go env -w GONOSUMDB=git.yourcompany.com go env -w GONOPROXY=""
GONOSUMDB 用于跳过私有模块的 checksum 校验，避免因未收录而失败。
基本上就这些。只要配置好 GOPRIVATE、Git 认证和模块路径，Golang 就能无缝使用私有模块。不复杂但容易忽略细节，比如路径大小写、token 权限、replace 未删除等。
