go mod init 推导出错因路径自动推导导致模块名不符预期，应清理残留文件后显式指定模块路径（如example.com/myapp），并确保与import语句及私有仓库地址一致；go get版本不生效是mvs算法按全局依赖约束选择最小可行版本所致，需确认tag存在、用go mod edit强制require或指定commit哈希；私有模块需配置goprivate并验证，vendor构建必须显式加-mod=vendor参数。
go mod init 推导出错：模块路径不是你想要的
执行 go mod init 后，go.mod 第一行出现类似 module github.com/yourname/project 这种路径，但你根本没托管在 GitHub，甚至项目是内部私有库——这不是 bug，是 Go 在 $GOPATH/src 下或路径含常见域名时自动推导的结果。
这种推导会污染后续所有依赖解析：比如你用 replace 指向本地路径，但 import 语句仍是 github.com/yourname/project，Go 不认；或者 CI 构建时因 GOPROXY 不代理该路径而失败。
- 先清理残留：
rm -f go.mod go.sum Gopkg.lock vendor/ - 显式指定模块名：
go mod init example.com/myapp（域名不需真实存在，仅作命名空间） - 若已推送到私有 GitLab：
go mod init gitlab.internal.company/group/project - 初始化后立刻检查
go.mod首行是否为你写的路径，不是就手动改，并运行go mod tidy
go get @vX.Y.Z 不生效：版本被 MVS 算法忽略
写 go get github.com/sirupsen/logrus@v1.9.3，结果 go.mod 没变，或实际加载的是 v2.0.0+incompatible——这不是命令失败，而是 Go 的最小版本选择（MVS）在起作用：它要满足整个依赖图的约束，不是“你写啥就装啥”。
常见干扰源是其他依赖已 require github.com/sirupsen/logrus/v2，而 v1 和 v2 是不同模块路径，Go 直接跳过你的请求。
- 确认 tag 存在：
curl -I https://proxy.golang.org/github.com/sirupsen/logrus/@v/v1.9.3.info（返回 200 才有效） - 强制锁定（不触发升级逻辑）：
go mod edit -require=github.com/sirupsen/logrus@v1.9.3+go mod tidy - 想用 commit 而非 tag：
go get github.com/sirupsen/logrus@55046e2（哈希必须完整或至少 12 位） -
@latest≠ master 分支，而是语义化版本中最高合法 patch 版本，可能跳过预发布版
私有模块报 unknown revision 或 403：GOPRIVATE 没配全
执行 go mod tidy 卡在某个公司内网 GitLab 地址，报 unknown revision 或 403 Forbidden，本质是 Go 仍把请求发给了代理，而不是直连你的私有仓库。
哪怕你设了 GOPROXY=https://goproxy.cn,direct，只要 GOPRIVATE 没覆盖对应域名，Go 就不会启用 direct fallback。
- 加进
GOPRIVATE：go env -w GOPRIVATE="gitlab.internal.company,github.com/my-org/*"（逗号分隔，无空格，支持通配符） - 验证是否生效：
go env GOPRIVATE必须输出你刚设的值 - HTTPS 私库需 Git 凭证：
git config --global credential.helper store，然后手动git clone一次输账号密码 - SSH 方式更稳：确保
~/.ssh/id_rsa已添加到平台，且go.mod中路径为git@gitlab.internal.company:group/project
vendor 目录构建仍走网络：-mod=vendor 没加
go mod vendor 执行完，vendor/ 里确实有文件，但 go build 还是去拉远程包、甚至报 checksum mismatch——因为 Go 默认忽略 vendor，除非你明确告诉它用。
vendor 不是开关，是构建模式。即使有 vendor 目录，Go 1.14+ 默认仍走 GOPROXY，只在缺失依赖时 fallback 到 vendor。
- 构建时显式启用：
go build -mod=vendor - CI 中建议统一加环境变量：
GOFLAGS="-mod=vendor" -
go mod vendor不会自动更新内容，改了go.mod后必须重跑一遍 - vendor 缺少间接依赖？用
go list -m all | grep -v "=>"对比vendor/modules.txt找漏掉的模块
GOPROXY、GOPRIVATE、go.mod 路径、import 路径）之间存在隐式耦合，改一处不联动，问题就藏得更深。
