go mod tidy 不会自动处理跨模块依赖，仅同步 go.mod 与 import；需手动配置 replace、go_private 或确保子模块含 go.mod，否则报 unknown revision 等错。
go mod tidy 会自动处理跨模块依赖吗
不会自动处理，但能帮你发现并修正问题。go mod tidy 的作用是同步 go.mod 和实际代码中的 import，它会添加缺失的 module 依赖、删除未使用的 module，但前提是：所有被 import 的包必须能被 Go 工具链解析到——这在跨模块（尤其是私有模块或本地多模块项目）时经常失败。
常见错误现象：go mod tidy 报错 unknown revision 或 module not found，本质是 Go 无法定位目标模块的源码位置。
- 如果依赖的是同一仓库下的其他模块（如
github.com/user/repo/submodule），确保该子模块根目录下有go.mod，且主模块的go.mod中未用replace错误覆盖 - 若依赖本地未发布的模块（比如开发中并行修改两个模块），必须显式用
replace指向本地路径，例如：replace github.com/user/dep => ./local/dep
- 私有 Git 仓库需配置
GO_PRIVATE环境变量，否则 Go 默认走 proxy，导致认证失败或跳过私有域名
replace 和 require 同时存在时哪个生效
replace 优先级永远高于 require。只要 go.mod 中存在匹配的 replace 规则，Go 工具链就会忽略 require 声明的版本和源地址，直接使用 replace 指定的路径或版本。
这在跨模块调试时很实用，但也容易埋坑：比如忘记删掉临时 replace，上线构建时仍指向本地路径，导致 CI 失败。
千博企业网站管理系统个人版免费下载、免费使用、功能无限制，完全免费拥有(请尊重开发者版权，保留首页底部版权显示)：内含Flash动画源码、Access数据库程序包、SQL数据库程序包。 千博企业网站管理系统个人版特点： 1.全站模块化操作，静态标签调用，更强扩展性… 千博企业网站系统个人版是一套基于.Net + Access(SQL)建站管理系统软件、不依赖于服务商特定空间、不需安装任何空间商组
立即学习“go语言免费学习笔记（深入）”；
-
replace只影响当前模块的构建，不传递给下游依赖（除非下游也写了自己的replace） - 用
go list -m all查看实际解析的模块路径，确认是否被replace覆盖 - CI 环境建议禁用
replace：可通过go mod edit -dropreplace=xxx临时清理，或用不同go.mod文件区分开发/发布分支
多个 go.mod 共存时如何避免版本冲突
Go 不支持“工作区级统一版本锁”，每个 go.mod 独立管理自己的 require 和 go.sum。当模块 A 依赖模块 B v1.2.0，而模块 C 依赖模块 B v1.5.0，且 A 和 C 同时被主模块引入时，Go 会尝试升级 B 到满足两者的最小版本（通常是 v1.5.0），但前提是 B 的 API 兼容——否则编译或运行时出错。
这不是工具缺陷，而是 Go 的最小版本选择（MVS）机制决定的：它只保证构建通过，不保证行为一致。
- 用
go mod graph | grep 'module-b'查看具体哪个模块拉入了哪个版本 - 若需强制统一版本，可在主模块的
go.mod中显式require目标版本，并加// indirect注释说明意图（虽不改变解析逻辑，但起文档作用） - 真正可靠的解法是收敛模块边界：把高频共用的包抽成独立可发布模块，避免在多个子模块中重复实现或 fork
为什么 go build 能过但 go test 报找不到包
因为 go test 会额外加载 _test.go 文件中的 import，而这些文件可能引用了仅在测试时需要、但未在主 require 中声明的模块（比如 testify 或本地 mock 模块）。更隐蔽的情况是：测试文件 import 了同目录下未导出的内部包，而该包又依赖另一个模块——但那个模块没出现在当前 go.mod 的 require 列表里。
- 运行
go test -v -x查看实际执行的命令，注意go list阶段是否报错 - 对测试专用依赖，应显式
go get -t xxx或直接go mod tidy -compat=1.21（新版会更严格检查测试依赖） - 避免在
*_test.go中 import 主模块外的、未被require的子模块路径；如必须，就在主go.mod中require它
go.mod 都是一份独立的契约。 
