Go modules 初始化失败主因是路径推断错误或残留文件干扰，应清理后显式指定module path；go get版本不生效因默认升级而非锁定，需确认tag存在或强制commit；vendor需配合-mod=vendor构建且定期更新；replace与exclude共存时顺序和版本号须谨慎处理。
Go modules 初始化失败：go mod init 报错或生成错误模块名
执行 go mod init 时，如果当前目录已有 go.sum 或旧的 Gopkg.lock，可能干扰初始化；更常见的是模块路径推断出错——比如在 $GOPATH/src 下直接运行，Go 会尝试从路径推导 module name，导致生成类似 module github.com/username/project 的错误假设（实际你并未托管在 GitHub）。
实操建议：
- 先清理残留：
rm -f go.mod go.sum Gopkg.lock vendor/ - 用显式路径初始化：
go mod init example.com/myapp（域名不需真实存在，仅作命名空间，避免未来重命名麻烦） - 若项目已提交到私有 Git 仓库，可直接用其地址：
go mod init gitlab.example.com/group/project - 初始化后检查
go.mod第一行是否为预期 module path，不是则手动修正并运行go mod tidy重建依赖图
go get 拉取特定版本失败：@v0.12.3 不生效或回退到 latest
go get 默认行为是升级到满足要求的最新兼容版本，而非精确锁定。写 go get github.com/sirupsen/[email protected] 看似指定版本，但若 go.mod 中已有更高主版本（如 v2.0.0+incompatible），它可能拒绝降级；若该 tag 不存在或未被 Go proxy 缓存，也会 fallback 到 latest 并报 warning。
实操建议：
- 确认 tag 存在：
curl -I https://proxy.golang.org/github.com/sirupsen/logrus/@v/v1.9.3.info - 强制使用确切 commit：
go get github.com/sirupsen/logrus@55046e2 - 想彻底禁用自动升级，改用
go mod edit -require=github.com/sirupsen/[email protected]+go mod tidy - 注意
@latest不等于master分支，而是语义化版本中最高合法 patch 版本，可能跳过预发布版
vendor 目录未更新或构建仍走 proxy：go mod vendor 失效
go mod vendor 只复制 go.mod 中声明的直接依赖及其 transitive 依赖，但不会自动更新 vendor 内容；更关键的是，Go 1.14+ 默认启用 GOPROXY，即使有 vendor，go build 仍可能绕过它去拉远程包（尤其当本地 vendor 缺少某间接依赖时）。
