报错“module declares its path as … but was required as …”本质是模块路径不一致：go.mod中声明的module名与import或require路径不匹配，需确保二者字符串完全一致，并通过go mod tidy验证。
go mod tidy 报错：module declares its path as … but was required as …
这是子目录缺失最典型的报错，本质是 go.mod 文件中声明的模块路径（module github.com/user/repo/subdir）和你在其他项目里 require 的路径不一致。比如你本地只 clone 了根仓库 github.com/user/repo，却在某处写了 import "github.com/user/repo/subdir"，而该子目录下没有自己的 go.mod，Go 就无法识别它是一个独立模块——于是拒绝解析依赖。
- 检查报错中提到的模块路径是否真实存在对应子目录，且该子目录下有
go.mod - 如果只是想复用代码而非发布子模块，不要在子目录写
go.mod；所有 import 应基于根模块路径，例如github.com/user/repo/internal/subpkg，而非另起模块名 - 若确需子模块（如提供独立 SDK），必须在子目录初始化：进入
subdir/后运行go mod init github.com/user/repo/subdir，并确保其go.mod中module行与 import 路径完全一致
子目录有 go.mod 但 go build 失败：no required module provides package
即使子目录有 go.mod，Go 也不会自动“发现”它——除非上级模块显式 require 了它。根模块的 go.mod 默认只管理自身路径下的包，子模块属于另一个独立模块，必须被显式依赖。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 在根模块的
go.mod中添加require github.com/user/repo/subdir v0.0.0（版本可先占位） - 然后运行
go mod tidy，它会自动拉取子模块并修正版本号 - 注意：子模块的版本不能靠本地文件系统“软链接”或相对路径绕过；必须通过远程 tag 或
replace显式指向本地路径，例如：replace github.com/user/repo/subdir => ./subdir
使用 replace 指向本地子目录后，go test 报错：cannot find module providing package
replace 只影响构建时的模块解析，不影响 go test 对测试文件所在模块的判定。如果你在子目录下执行 go test，而该子目录没有 go.mod，Go 会尝试向上查找最近的 go.mod（通常是根目录），但此时 import 路径又按子模块声明，导致路径错配。
- 子目录要能独立测试，必须有自己的
go.mod，且module声明与 import 路径一致 - 若用
replace，确保replace行写在**被测试模块**的go.mod中（不是根模块的） - 避免在子目录里执行
go test ./...时混用不同模块路径；推荐统一在子目录下运行go test，且其go.mod已正确声明
为什么 go list -m all 不显示子模块？
go list -m all 列出的是当前构建所解析出的**实际参与编译的模块**，不是文件系统里的所有 go.mod。如果某个子目录的 go.mod 没被任何 import 引用、也没被 require 或 replace 涉及，它就根本不会出现在列表里——Go 不会扫描子目录主动加载模块。
- 确认是否有代码 import 了该子模块路径（如
"github.com/user/repo/subdir"） - 确认根模块的
go.mod是否require或replace了它 - 运行
go mod graph | grep subdir可直观查看该模块是否被依赖图包含
go.mod 一旦存在，就必须和所有 import 路径、require 条目、replace 目标保持字符串级完全一致——多一个斜杠、少一个版本号、大小写偏差，都会让整个链路中断。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
