必须显式指定合法模块路径，如go mod init github.com/your-org/project-name，确保go.mod首行module声明与所有import前缀完全匹配，禁用短路径和GOPATH式引用。
go mod init 报 “cannot determine module path” 怎么办
这不是环境问题，是 Go 拒绝猜路径。它不会从目录名、Git remote 或 GOPATH 推断模块名，尤其当项目没配 Git 或路径不规范时。
必须显式指定合法模块路径：
-
go mod init github.com/your-org/project-name（推荐，和未来 import 前缀一致） - 别用
./myproj、myproject或绝对路径——Go 模块路径必须是可解析的域名格式 - 执行后立刻检查
go.mod第一行：module github.com/your-org/project-name，确保它和所有import语句开头完全匹配
旧 vendor/ 目录还在，go build 却不生效
Go Modules 默认忽略 vendor/，但如果你没删干净，本地 go build 可能仍 fallback 到旧 vendor 逻辑，导致改了 go.mod 版本却没效果。
三步清理：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 先
rm -rf vendor，彻底删除旧 vendor 目录 - 确认
GO111MODULE=on（go env GO111MODULE输出应为on） - 临时验证是否真走 Modules：
go build -mod=readonly；如果报missing required module，说明现在才真正依赖go.mod
import 路径还是短名字，编译失败
GOPATH 时代允许 import "utils" 或 import "server/handler"，Modules 下这些路径全部失效——Go 不再按 $GOPATH/src 解析，只认完整模块路径。
哪些要改，哪些不用动：
- 跨项目引用必须改：比如原
import "mylib"→ 改成import "github.com/your-org/project-name/mylib" - 本地子包不用改：
import "./config"、import "./internal/db"这类点号路径始终有效 - 用
grep -r 'import "' . --include="*.go" | grep -v '"/'快速扫出疑似短路径，人工核对
CI 构建失败，但本地好好的
根本原因不是网络或版本，而是 CI 环境残留 GOPATH 习惯或 Modules 配置不一致。
重点检查三项：
- CI 脚本里删掉所有
export GOPATH=...和go get xxx安装工具命令；改用go install golang.org/x/tools/cmd/goimports@latest - 确保
GO111MODULE=on显式设置（不要依赖 Go 版本默认值，旧镜像可能仍是 off） - Docker 构建时，如果
COPY的源码没有go.mod，go build会退化为 GOPATH 模式并报no Go files in current directory
最容易被忽略的是：迁移后 go.mod 里写了 replace 指向本地路径，但 CI 没同步对应目录，导致 go build 静默跳过 replace 并拉远端包——这种失败不会报错，只会行为异常。
