私有模块需配置 goprivate 环境变量以跳过代理和校验；拉取时依赖 git 认证（推荐 ssh）；版本应打符合 vx.y.z 格式的 tag；vendor 会引发权限泄露与 replace 失效问题。
私有模块必须显式配置 GOPRIVATE
Go 默认只信任 github.com、gitlab.com 等公开托管平台的模块，访问私有仓库（如公司内网 GitLab、GitHub Enterprise、自建 Gitea）时会报错：module github.com/internal/lib: reading https://proxy.golang.org/github.com/internal/lib/@v/list: 404 Not Found。根本原因不是网络不通，而是 Go 工具链默认启用代理和校验，且未被告知哪些域名可跳过这些机制。
解决方式是设置环境变量 GOPRIVATE，告诉 go 命令哪些路径属于私有模块，不走代理、不查 checksum、不校验证书（若用 HTTP 或自签名证书）：
export GOPRIVATE="git.example.com,github.com/myorg"
多个域名用逗号分隔，支持通配符（如 *.example.com），但不支持路径段匹配（git.example.com/internal/* 无效，得写全 git.example.com/internal 或直接 git.example.com）。
go get 无法拉取私有模块？检查认证方式
go get 在拉取私有模块时，本质是调用 git clone，所以它依赖系统级的 Git 凭据管理。常见失败现象是卡在 Cloning into '/tmp/...'... 或报错：fatal: could not read Username for 'https://git.example.com': No such device or address。
立即学习“go语言免费学习笔记（深入）”；
推荐按优先级尝试以下方式：
- 使用 SSH URL（如
git@git.example.com:myorg/lib.git），并确保本地~/.ssh/id_rsa已添加到 Git 服务的部署密钥或用户 SSH Key 中 - 若必须用 HTTPS，配置 Git 凭据助手：
git config --global credential.helper store，然后首次手动git clone https://git.example.com/myorg/lib触发用户名密码输入并保存 - 临时绕过：在
go get前设GIT_TERMINAL_PROMPT=0防止交互阻塞，但需确保凭据已就位
注意：go 不读取 .netrc，也不支持在 import path 中嵌入用户名密码（如 https://user:pass@git.example.com/...），该写法已被 Go 1.19+ 显式拒绝。
私有模块版本打 tag 还是用 pseudo-version？
私有模块同样遵循 Go Module 的语义化版本规则，但因不走官方 proxy，go mod tidy 无法自动解析 v1.2.3 对应的 commit，除非你显式打 Git tag：
git tag v1.2.3 && git push origin v1.2.3
否则 go 会生成 pseudo-version（如 v0.0.0-20240520103045-abcdef123456），它由时间戳 + commit hash 构成，虽能锁定代码，但不利于人工识别和协作沟通。
关键点：
- tag 名必须符合
vX.Y.Z格式（前面带v），否则go list -m -versions不识别 - 私有模块的
go.mod文件中module行路径必须与实际 Git 仓库地址一致（如module git.example.com/myorg/lib），否则go get会找不到对应 repo - 若想让
go list -m -versions正常列出所有 tag，确保 Git 服务器允许匿名 fetch refs（多数私有 Git 服务默认关闭，需开启或走认证）
vendor 里存私有模块？小心重复拉取和权限泄露
执行 go mod vendor 会把所有依赖（含私有模块）复制进 vendor/ 目录，看似能规避运行时网络依赖，但带来两个现实问题：
- CI 构建时若未配置
GOPRIVATE和 Git 凭据，go mod vendor本身就会失败——因为 vendor 前要先 resolve 模块，这步仍需拉代码 - vendor 目录可能被误提交进公开仓库，导致私有模块源码意外暴露（尤其当私有模块含敏感逻辑或硬编码凭证）
更稳妥的做法是：在 CI 环境中保留 GOPRIVATE + Git 凭据，直接构建而不 vendor；仅在离线环境或强审计要求场景下才启用 vendor，并配合 .gitignore 明确排除 vendor/ 下的私有路径（如 vendor/git.example.com/**），再人工审查。
真正容易被忽略的是：私有模块的 replace 指令（如 replace git.example.com/myorg/lib => ./local-lib）在 go mod vendor 后会失效——vendor 只包含 replace 前的原始模块内容，不会映射到本地路径。
