私有 git 仓库在 go modules 下能运行，但失败主因是路径映射、认证方式、环境变量三者错位；go.mod 路径须与 git url 去协议和.git后缀后严格匹配，goprivate 必须正确配置通配符，认证需复用 git 凭据机制，replace 不影响 go.sum 校验，且私有模块必须含合法 go.mod 文件。
私有 Git 仓库依赖在 Go Modules 下能跑通，但失败几乎都卡在路径、认证、环境变量三者的错位上——不是 Go 不支持，而是它严格复用 Git 的行为逻辑。
go.mod 中的模块路径必须和 Git 仓库地址可映射
Go 不会自动把 git.example.com/internal/utils 转成 https://git.example.com/group/utils.git。它只做简单前缀匹配：模块路径必须是 Git 地址去掉协议和 .git 后缀后的结构。
- 正确示例：Git 仓库 URL 是
https://git.example.com/myorg/lib→go.mod中写module git.example.com/myorg/lib - 错误示例：
module mylib、module ./lib、module internal/lib—— 这些都会导致go mod download报unknown revision或module not found - SSH 用户注意：
git@git.example.com:myorg/lib.git需要在~/.gitconfig里加[url "git@git.example.com:"] insteadOf = https://git.example.com/，否则 go 默认走 HTTPS 协议并失败
GOPRIVATE 必须设对，否则 go get 会走代理并校验失败
GOPRIVATE 不是“开关”，而是白名单前缀列表；漏掉一个字符或没加 /*，私有模块就会被 proxy.golang.org 拦截或 checksum 校验中断。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 正确设置：
export GOPRIVATE=git.example.com/*,gitee.com/yourname/*（多个用逗号分隔，通配符/*不可省） - 错误设置：
GOPRIVATE=git.example.com（缺/*）、GOPRIVATE=*.example.com（不支持通配符开头） - CI 环境中建议显式导出：
GOPRIVATE=git.example.com/* go mod tidy，避免继承宿主环境遗漏
认证方式必须和 git clone 一致，Go 自己不处理 token 或密码
Go 调用的是系统 git 命令，所有凭据逻辑完全复用 Git 的 credential helper 或 SSH agent。你在终端能 git clone 成功，go mod tidy 才可能成功。
- HTTPS 方式：用
git config --global credential.helper store，然后首次git clone输入账号密码，之后 git 和 go 都能复用 - SSH 方式：确保
ssh -T git@git.example.com能通，且私钥已加载到ssh-agent（eval $(ssh-agent); ssh-add ~/.ssh/id_ed25519） - 禁止在
go.mod或 URL 中硬编码 token：https://token:x-oauth-basic@git.example.com/...只适用于 GitHub/GitLab，且有泄露风险；gitee 等平台可能不识别该格式
go.sum 记录的是原始模块哈希，replace 后本地修改不触发校验失败
当你用 replace github.com/some/lib => ./local-fix 时，go.sum 仍存原始模块的哈希值。这意味着：本地改代码不会报错，但上线构建时若没删 replace 或没切回真实版本，就可能跑错逻辑。
- 开发期可用 replace 快速验证补丁，但提交前务必确认是否要保留
- 上线前运行
go mod graph | grep some-lib查看是否还有间接依赖指向被 replace 的模块 - CI 流程中应加
go mod verify，防止go.sum被绕过或篡改
最常被忽略的一点：私有模块的 go.mod 文件本身也必须存在且合法——哪怕只是空模块，也要有 module git.example.com/xxx 行。没有它的仓库，Go 工具链连解析入口都没有。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
