根本原因是go调用git时默认走https协议且不支持交互式认证，导致401错误；需配置ssh替代https或注入personal access token，并同步设置goprivate与gonosumdb确保跳过代理和校验。
go get gitee.com/xxx 报 401 或 fatal: could not read Username
根本原因是 Go 调用 git 时走的是 HTTPS 协议，而 Gitee 私有仓库默认要求认证，但 go get 不会弹出交互式用户名/密码输入（尤其在 CI 或 go mod tidy 场景下），导致 git 返回 401 或 terminal prompts disabled 错误。
- 不要用
go get -insecure—— 它只跳过 TLS 校验，不解决认证问题，且已被 Go 1.20+ 弃用 - 优先改用 SSH：配置
git config --global url."git@gitee.com:".insteadOf https://gitee.com/，确保本地已有对应 SSH key 并已添加到 Gitee 账户 - 若必须用 HTTPS，可临时注入凭据（仅限开发机）：
git config --global url."https://<username>:<token>@gitee.com/".insteadOf https://gitee.com/</token></username>，其中<token></token>是 Gitee 的 Personal Access Token（不是密码） - 注意：Gitee 的 token 需勾选
repo权限，且不能含特殊字符（如/、@），否则 git 解析 URL 失败
GOPRIVATE 设置了还是校验 sumdb 失败
GOPRIVATE 控制的是代理和校验跳过，但它**不自动禁用 checksum 验证**。如果模块路径匹配 GOPRIVATE，Go 仍会尝试从 GOSUMDB 查询校验和 —— 而私有库显然不在 sum.golang.org 或其他公开 sumdb 上，于是报 verifying xxx@v0.0.0-xxx: checksum mismatch。
- 必须同步设置
GONOSUMDB或GOSUMDB=off：go env -w GONOSUMDB=gitee.com/**（通配符需与GOPRIVATE一致） -
GONOSUMDB和GOPRIVATE必须严格匹配：比如GOPRIVATE=gitee.com/my-org/*，则GONOSUMDB也得是gitee.com/my-org/*，不能写成gitee.com/* - 验证是否生效：
go env | grep -E "(GOPRIVATE|GONOSUMDB|GOSUMDB)"，确认两者都非空且值合理
go mod tidy 后间接依赖里混入公有版本的同名模块
常见于你引用了私有模块 A，而 A 又依赖了某个开源项目 B（比如 golang.org/x/net），但 B 的某个子模块被另一个公有依赖以不同版本拉入 —— 导致 go list -m all | grep x/net 显示多个版本，编译时报类型冲突。
- 这不是私有库专属问题，但私有模块常因未打 tag 或用伪版本加剧该现象
- 先定位污染源：
go mod graph | grep 'golang.org/x/net@'看谁引入了旧版 - 若污染来自测试工具（如
gotest.tools），升级该工具版本往往比replace更稳妥 - 慎用
exclude：它只屏蔽特定版本，不解决依赖图本质矛盾；replace只影响你代码里的 import 解析，不影响间接依赖的版本选择
CI 构建时 go mod download 失败，本地却正常
本地能过是因为你个人环境里有 SSH key 或 git 凭据缓存，而 CI 环境是干净容器，没有这些上下文，即使 GOPRIVATE 正确也会卡在 git clone 阶段。
- CI 脚本开头必须显式注入凭据：GitHub Actions 用
git config --global url."https://${{ secrets.GITEE_TOKEN }}@gitee.com/".insteadOf https://gitee.com/ - SSH 方式更可靠：把私钥写入 CI secret，再用
ssh-add加载，并确保~/.ssh/config有对应 Host 别名（如Host gitee.com\n User git\n IdentityFile ~/.ssh/id_rsa_gitee） - 关键检查点：运行
git ls-remote -h https://gitee.com/xxx/yyy.git（或对应 SSH URL）验证 CI 环境能否直连，这比go mod tidy报错信息更早暴露问题
GOPRIVATE 写没写对，而是 git 层的协议、凭据、CA 信任链这三层叠加失效 —— 每一层都可能单独工作，但合起来就静默失败。
