module路径写错会导致import语句不合法，引发编译错误或类型不匹配；必须与所有import路径完全一致，否则跨项目复用、依赖解析、CI构建均会失败，修复成本远高于初始化时正确指定。
go mod init 时 module 路径写错会怎样
module 路径不是随便起的，它直接决定 import 语句的合法性。比如你在 ~/myproj 下执行 go mod init myapp，生成的 go.mod 里是 module myapp，但代码里若写 import "github.com/you/myapp"，Go 就会报 imported and not used 或更隐蔽的类型不匹配——因为编译器认为这是两个不同包。
正确做法是让 module 声明与你未来实际引用路径一致。哪怕项目还没推到 GitHub，也应按目标地址初始化：
- 本地开发：用真实域名占位，如
go mod init example.com/myproj - 私有 Git：用公司内网地址，如
go mod init gitlab.internal/foo/bar - 避免用单个单词（
myapp）、相对路径（./myapp）或本地文件路径（file:///tmp/myapp）
一旦写错，后续所有依赖（尤其是跨项目复用的包）都会因 import 路径不一致导致类型不可互换，修复成本远高于初始化时多敲几个字符。
私有仓库依赖无法拉取：GO_PRIVATE 和 replace 的取舍
当你 import 一个私有 Git 地址（如 gitlab.company.com/internal/pkg），go get 默认走 proxy.golang.org，结果就是 unknown revision 或 403 Forbidden。
立即学习“go语言免费学习笔记（深入）”；
两种解法，适用场景完全不同：
-
GO_PRIVATE=gitlab.company.com：告诉 Go 工具链“这个域名下的模块不走代理，直接 clone”，需配 SSH 或 HTTPS 凭据，适合 CI/CD 和团队统一环境 -
replace gitlab.company.com/internal/pkg => ./internal/pkg：仅在当前模块生效，指向本地路径，适合开发调试，但必须确保被 replace 的目录下有合法go.mod，且不能漏掉子模块的go.mod
注意：replace 不会传递给下游依赖——如果 A 用了 replace 指向本地 pkg，B 依赖 A，B 仍然会尝试从远程拉取 pkg，除非 B 也单独加 replace。CI 构建前务必清理 replace，否则构建机找不到 ./internal/pkg。
go mod tidy 报 “no required module provides package” 怎么办
这错误本质是 Go 找不到 import 路径对应的模块根目录（即含 go.mod 的目录）。常见于三种情况：
- 你 import 了
github.com/you/lib/sub，但该 repo 根目录没go.mod，或者sub目录本身没独立go.mod（Go 不支持子目录自动升格为模块） - 你误把 vendor 内路径当 import 路径，比如写了
import "myproj/vendor/github.com/some/lib"—— 这是绝对禁止的，vendor 是工具产物，不是 import 源 - 跨模块引用时，主模块的
go.mod里没声明依赖，而go mod tidy又拒绝自动补全“未发布”的模块（比如还在 feature 分支、没打 tag）
解决优先级：先确认被 import 的路径是否真有 go.mod；没有就加；有但路径不对，就改 import；实在不行再用 replace 临时绕过，但得同步加 // +build ignore 注释提醒自己这是临时方案。
多个 go.mod 共存时版本冲突的实际影响
Go 不搞工作区级版本锁，每个 go.mod 独立解析。比如你的主项目依赖 modA v1.2.0，而 modA 自身依赖 libX v1.5.0，同时主项目又直接依赖 libX v1.8.0，Go 会按 MVS 算法选 v1.8.0 并要求 modA 兼容——但兼容性只检查 API 层面，不保证行为一致。
这意味着：
- 编译能过，运行可能 panic（比如
libX的某个方法在 v1.8.0 改了返回值语义） -
go list -m all显示的版本是最终选用的，不是各模块声明的原始版本 - 想锁定具体版本？只能在主
go.mod中显式require libX v1.5.0，并接受modA可能因不兼容而构建失败
最易被忽略的一点：这种冲突在本地开发时可能被缓存掩盖（go.sum 里旧哈希还在），但 CI 清理缓存后立刻暴露。别依赖“我本地能跑”来判断稳定性。
