需配置GOPRIVATE与GONOSUMDB环境变量声明私有域名，并通过~/.netrc文件设置Token认证，使go get自动携带凭证拉取私有模块。
配置Go私有模块仓库的Token认证
Go本身不内置私有模块仓库服务，但可通过支持go get协议的第三方服务（如GitLab、GitHub、Gitea、JFrog Artifactory或自建goproxy）实现私有模块访问控制。核心在于让go命令在拉取模块时能自动携带身份凭证（如Personal Access Token或Basic Auth），避免手动输入密码或401错误。
在GOPRIVATE和GONOSUMDB中声明私有域名
Go需要知道哪些模块路径属于“私有范围”，才不会走公共代理或校验公开checksum。必须提前配置环境变量：
-
GOPRIVATE：指定匹配的模块路径前缀（支持通配符），例如
GOPRIVATE=git.example.com,github.com/my-org/* -
GONOSUMDB：与
GOPRIVATE保持一致，禁用sum数据库校验，例如GONOSUMDB=git.example.com,github.com/my-org/*
推荐写入~/.bashrc或~/.zshrc并执行source生效。未配置会导致go get失败并提示“module not found”或“checksum mismatch”。
设置凭证：netrc或GIT_AUTH_PATH（推荐netrc）
Go CLI通过git底层拉取代码，因此复用Git的凭证机制。最常用且安全的方式是使用~/.netrc文件：
立即学习“go语言免费学习笔记（深入）”；
- 创建文件：
touch ~/.netrc，并设权限chmod 600 ~/.netrc - 写入内容（以GitLab为例）：
machine git.example.com
login your-username
password your_personal_access_token - 确保Git已配置
git config --global credential.helper netrc
注意：token需具备read_api和read_repository权限（GitLab）或repo权限（GitHub）。不要使用账号密码，仅限Token。
验证与调试模块拉取行为
运行以下命令确认配置生效：
-
go env GOPRIVATE—— 检查是否包含目标域名 -
go list -m -u all 2>&1 | grep "private"—— 观察是否有私有模块解析日志 -
go get git.example.com/my-team/mylib@v1.2.0—— 实际触发拉取，观察是否静默成功（无prompt、无403） - 启用调试：
GODEBUG=httptrace=1 go get ...可查看HTTP请求头是否含Authorization
若仍失败，检查网络能否直连仓库、Token是否过期、仓库是否开启go.mod和go.sum提交，以及模块路径是否与module声明完全一致。
