根本原因是git未配置凭据导致go get在https认证时静默失败；解决方案包括切换至ssh协议（需预置ssh key）或启用git凭据存储（git config --global credential.helper store），并确保goprivate正确设置以避免私有模块被代理拦截。
git config 未配导致 go get 报 fatal: could not read Username
这是最常被忽略的底层原因：Go 调用 go get 时默认走 HTTPS 协议拉代码，但很多私有 Git 仓库（比如内部 GitLab、Gitee 企业版）要求认证，而 Go 不会弹出用户名密码输入框 —— 它直接失败，报错里只显示 fatal: could not read Username for 'https://git.example.com': terminal prompts disabled。
- 根本不是 Go 的问题，而是 Git 自身拒绝交互式认证
- 解决方案不是改 Go 配置，而是让 Git 能静默提供凭据：用
git config --global url."git@git.example.com:".insteadOf "https://git.example.com/"切到 SSH 协议（前提是已配好 SSH key） - 或者用 HTTPS + 凭据存储：执行
git config --global credential.helper store，再手动访问一次仓库 URL 触发弹窗登录，Git 会把 token 存进系统凭据管理器 - Windows 上注意：凭据要存到“Windows 凭据管理器”里，名称必须是
git.example.com，不能带https://前缀
GOPRIVATE 没设导致私有模块被代理拦截
Go 默认把所有模块都扔给 GOPROXY（如 proxy.golang.org）去查，但私有域名（比如 git.internal.company）不可能在公共代理上存在 —— Go 就卡住，报 no required module provides package 或 reading .../go.mod at revision ...: git ls-remote -q origin: exit status 128。
-
GOPRIVATE必须显式设置，且值要和 import 路径前缀完全一致，比如git.internal.company，不能写成https://git.internal.company - 多个域名用逗号分隔：
export GOPRIVATE="git.internal.company,gitlab.myorg.com" - 设完后运行
go env GOPRIVATE确认生效，否则go mod tidy还是走代理 - CI 环境尤其容易漏：Heroku、GitHub Actions 都得在 workflow 或 config 中显式 set 环境变量
go.sum 校验和 mismatch 本质是 Git 拉取源不一致
错误信息里出现 verifying github.com/x/y@v1.2.0: checksum mismatch，表面是哈希对不上，实际源头往往是 Git 拉取行为被干扰 —— 比如本地 Git 配了代理、用了 fork 分支但没更新 tag、或依赖仓库重写了历史。
- 先跑
go clean -modcache清掉可能污染的缓存 - 再检查该模块是否真的能用 Git 直接 clone：
git ls-remote https://github.com/x/y.git v1.2.0，看 tag 是否存在 - 如果用的是私有仓库，确认
GOPRIVATE已设且git config能通，否则go mod download可能悄悄 fallback 到 proxy，拉到假数据 - 极端情况可临时关校验：
export GOSUMDB=off，但仅限调试，上线前必须恢复
子模块路径与 import 路径不一致引发 no required module
Git 子模块本身没问题，git submodule update --init 也成功了，但 go build 死活找不到包 —— 典型症状是报 no required module provides package github.com/org/util，哪怕 ./submodules/util 目录下明明有 go.mod。
- Go 不认“子模块挂在哪”，只认“import 路径字符串”和“磁盘路径字符串”是否逐字相等
- 正确做法：子模块必须挂载到和 import 路径末段一致的目录，比如
import "github.com/org/util"→ 挂到./util，而不是./libs/util - 实在不能改路径？用
go mod edit -replace github.com/org/util=./libs/util，但记得 CI 脚本里加git submodule update --init，否则 ./libs/util 是空的 - 子模块根目录下必须有
go.mod（哪怕只有module github.com/org/util一行），否则 Go 直接跳过它
git config 没配、一个 GOPRIVATE 漏写、一次子模块挂载路径偏差，都会让 go mod tidy 在静默中失败 —— 错误信息往往指向模块本身，而非真正的配置断点。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
