配置私有module需设置GOPRIVATE环境变量，如export GOPRIVATE=git.company.com；确保Git认证（SSH或HTTPS+Token）；模块路径与仓库一致；使用go get通过完整路径引入；可选配置GONOSUMDB跳过校验。
在使用 Golang 开发项目时，如果需要引用公司内部或私有的 module，不能像公开模块那样直接通过 go get 从公共仓库（如 GitHub、GitLab）拉取。此时就需要配置私有 module 仓库，让 Go 工具链知道如何正确获取这些模块。以下是完整的配置步骤。
1. 设置 GOPRIVATE 环境变量
为了避免 Go 在访问私有仓库时尝试通过公共代理（如 proxy.golang.org）下载模块，需要设置 GOPRIVATE 环境变量，告诉 Go 哪些模块是私有的，不应经过代理或校验 checksum。
例如，如果你的私有模块路径是 git.company.com/internal/lib，执行：export GOPRIVATE=git.company.com/internal/lib # 或者支持多个域名 export GOPRIVATE=git.company.com,gitlab.mycompany.com
也可以将该配置写入 shell 配置文件（如 .zshrc 或 .bashrc），避免每次重新设置。
2. 配置 Git 认证信息
Go 下载私有模块依赖于 Git，因此必须确保 Git 能够正确认证并访问你的私有仓库。常用方式有 SSH 和 HTTPS + Token 两种。
立即学习“go语言免费学习笔记（深入）”；
-
使用 SSH 方式（推荐）：
- 确保本地已生成 SSH 密钥，并添加到 Git 服务器（如 GitLab、GitHub、自建 Git 服务）。
- 模块导入路径应使用 SSH 格式，例如：
git@company.com:group/module.git - Go 会自动调用 ssh-agent 完成认证。
-
使用 HTTPS + Personal Access Token：
- 若使用 HTTPS 地址（如 https://git.company.com/group/module），需配置凭据存储。
- 可使用 Git 凭据助手保存用户名和 Token：
git config --global credential.helper store # 第一次 git pull 时输入用户名和 Token，会被记住
3. 正确声明模块路径
在私有项目中，go.mod 文件里的模块名必须与实际仓库路径一致。
例如，你的 Git 仓库地址为 git@company.com:backend/user-service.git，则 go.mod 应为：
module git.company.com/backend/user-service <p>go 1.19
其他项目引用它时，也应使用相同路径：
import "git.company.com/backend/user-service/auth"
4. 使用 go get 引入私有模块
在项目中引入私有模块时，直接使用完整模块路径：
go get git.company.com/backend/user-service@v1.0.0
Go 会通过 Git 拉取代码，并根据 tag 解析版本。如果尚未发布 tag，也可使用 commit hash：
go get git.company.com/backend/user-service@8a5e1f3
5. （可选）配置 GONOSUMDB
除了 GOPRIVATE，你还可以使用 GONOSUMDB 来跳过特定仓库的 checksum 验证：
export GONOSUMDB=git.company.com,github.com/myprivatefork
但通常只需设置 GOPRIVATE 即可，因为它已隐式包含 GONOSUMDB 的行为。
基本上就这些。只要确保环境变量设置正确、Git 认证可用、模块路径匹配，Go 就能顺利拉取私有 module。不复杂但容易忽略细节。
