根本原因是go无法自动推导合法模块路径，应显式指定如go mod init github.com/your-org/your-project，并确保go.mod首行与所有import前缀严格一致，同时清理旧vendor、检查goproxy等环境配置。
go mod init 报 “cannot determine module path” 怎么办
根本原因不是命令写错，而是 Go 没法从当前目录自动推导出合法模块路径——尤其当项目没配 Git、路径不在 $GOPATH/src 下、或目录名含非法字符（如空格、下划线开头）时。
直接显式指定路径，别依赖自动推断：go mod init github.com/your-org/your-project。模块名必须和后续所有 import 语句的前缀完全一致，比如代码里写了 import "github.com/your-org/your-project/handler"，那 go.mod 第一行就必须是 module github.com/your-org/your-project。
- 别用
./myapp、myapp或本地绝对路径（如/home/user/myproj），这些都不是有效模块路径 - 如果项目已托管在 GitHub，先确认
git remote get-url origin输出正确，再执行go mod init；但别把它当默认方案，手动指定更稳 - 执行完立刻检查
go.mod文件头，若第一行是module example.com/xxx却实际 import 用的是github.com/xxx/yyy，编译必报cannot find module providing package
旧 vendor 目录不删，go build 就不走 modules
Go Modules 启用后，go build 会优先读 vendor/ 目录（只要它存在），哪怕 go.mod 已更新、go.sum 已重算——这是最隐蔽的“白迁”陷阱。
迁移前必须彻底清理：rm -rf vendor。之后再跑 go mod tidy，让依赖真实落地到 go.mod 和 go.sum 中。想验证是否真走 modules，临时加 -mod=readonly：如果报错说缺某个 module，说明它终于开始查 go.mod 了。
- 旧
vendor/是 dep/glide/govendor 留下的，和 modules 不兼容；保留它等于锁死旧依赖关系 -
go mod vendor是重建命令，不是迁移命令——它只基于当前go.mod生成新 vendor，不会继承旧 vendor 的 patch 或 fork - 若必须保留 vendor（如 CI 禁外网），记得每次改
go.mod后都重新go mod vendor，并用diff -r vendor/ old_vendor/手动核对关键包是否被覆盖
import 路径还写 "utils" 或 "./config"？编译肯定失败
GOPATH 时代允许短路径导入，Modules 下只认完整模块路径。本地子包（如 ./config）仍可用点号，但跨包引用必须带前缀，且前缀要和 go.mod 声明的模块名严格对齐。
用 grep -r 'import "' . --include="*.go" | grep -v '^\.' | grep -v '"/' 快速扫出疑似短路径 import（比如 import "server"、import "models"），逐个改成 import "github.com/your-org/your-project/server"。
- 第三方包（如
github.com/sirupsen/logrus）不用改，它们本身已是完整路径 - 本地 replace 依赖（如
replace github.com/xxx/lib => ../lib）要求../lib目录下也有合法go.mod，否则go build会静默忽略 replace 并报错 - 如果项目用了
gopkg.in/yaml.v2这类重定向路径，得在go.mod里显式replace，例如：replace gopkg.in/yaml.v2 => gopkg.in/yaml.v2 v2.4.0
CI 构建失败，八成是 GOPROXY 或 GOSUMDB 没配
本地能过，CI 却卡在 go get -u 或报 checksum mismatch，大概率是 Go Modules 在校验阶段默认启用了 GOPROXY 和 GOSUMDB，而旧流水线脚本没适配。
CI 脚本里必须显式设置：GOPROXY=https://proxy.golang.org,direct（国内可换为 https://goproxy.cn,direct），GOSUMDB=off（若用私有 checksum db，则设为对应地址）。同时禁用所有硬编码的 go get 安装工具命令，改用 go install。
- 别信“本地能跑就行”，CI 环境没有 GOPATH 缓存、没有本地 proxy，行为更干净但也更脆弱
- Docker 多阶段构建中，FROM golang:1.19+ 镜像默认开启 Modules，但如果 COPY 进来的源码没有
go.mod，go build会 fallback 到 GOPATH 模式并报no Go files in current directory -
go env GOMOD输出应指向项目内go.mod文件；如果不是，说明当前工作目录不被识别为 module 根——常见于在子目录里误执行构建命令
go.mod 不等于改完了，得让每一处 import、每一个构建环境、每一条 CI 指令都重新对齐那个模块路径。
