Go不支持子目录嵌套go.mod，因模块以go.mod为边界且需唯一路径；强行添加会导致构建错误或依赖混乱，正确分层应通过internal/pkg包组织+模块路径语义实现。
为什么 go mod init 后不能直接嵌套多层 go.mod
Go 的模块系统（module）以 go.mod 文件为边界，每个模块必须有唯一、可导入的模块路径（如 github.com/user/project），且 go 工具链**不支持子目录下再声明独立模块**——除非你显式运行 go mod init 创建新模块。强行在子目录放 go.mod 会导致：go build 报错 main module does not contain package，或依赖解析混乱。
真正的“分层管理”不是靠物理嵌套模块，而是靠包（package）组织 + 模块路径语义 + 显式依赖声明。
- 顶层
go.mod是整个项目的主模块，所有内部包都属于它（即使路径是internal/service或pkg/repository） - 若需拆出可复用的独立模块（如
github.com/user/repo-core），必须：独立 Git 仓库 + 独立go.mod+ 语义化版本 + 通过require引入 -
internal/目录天然限制外部导入，适合放仅本项目使用的分层逻辑（如internal/handler,internal/usecase,internal/gateway）
如何用包路径模拟清晰的分层结构
Go 不强制 MVC 或六边形架构，但你可以通过包名和路径表达职责边界。关键不是“能不能分”，而是“怎么让 import 路径体现意图”。
推荐目录结构示例：
立即学习“go语言免费学习笔记（深入）”；
myapp/
├── go.mod
├── main.go
├── cmd/
│ └── myapp/
│ └── main.go // 只含初始化和启动逻辑
├── internal/
│ ├── handler/ // HTTP/gRPC 入口，只依赖 usecase
│ ├── usecase/ // 业务逻辑，只依赖 entity + gateway
│ ├── entity/ // 领域模型（structs + methods），无外部依赖
│ └── gateway/ // 外部依赖适配器（DB、HTTP client），实现 usecase 定义的 interface
└── pkg/
└── util/ // 可被 internal 和 cmd 共享的纯工具函数（无业务逻辑）
-
internal/下各包之间可以相互 import，但外部模块无法 importinternal/xxx—— 这是 Go 编译器强制的封装机制 -
pkg/是显式开放的公共包，适合提取通用能力（如pkg/logger,pkg/metrics），可被其他项目go get - 避免循环 import：例如
handler不能 importgateway，只能通过usecase定义的 interface 间接使用
什么时候该拆出独立模块？看这三点
不要为了“分层”而拆模块。Go 模块的本质是**可独立版本化、可被他人复用的单元**。拆之前问自己：
- 这个代码是否会被 3 个以上不同项目 直接
go get使用？ - 它的 API 是否稳定到能承诺
v1.0.0并遵守 semver？ - 它是否 完全不依赖当前项目的
internal/包？（否则就是假独立）
常见误拆场景：
- 把
internal/repository单独提成模块 → 它强依赖本项目的entity，别人无法单独用 - 为每个微服务建一个模块但共用同一 Git 仓库 →
go mod tidy会混乱，应统一用 monorepo + 单模块，靠cmd/分离可执行文件
go list -f 和 go mod graph 是验证分层的实际工具
写完包结构别光靠眼睛看，用命令验证依赖流向是否符合预期：
- 检查某包依赖了谁：
go list -f '{{.Deps}}' internal/handler - 确认没有反向依赖（比如
entity依赖了gateway）：go mod graph | grep 'entity.*gateway'
（应无输出） - 查看模块内所有包的 import 关系图（需安装
goplantuml）：go install github.com/evanw/esbuild/cmd/esbuild@latest && go install github.com/awalterschulze/goplantuml@latest
真正难的不是建目录，而是让每个 import 语句都传递明确的抽象意图——比如 import "myapp/internal/usecase" 表示“我需要业务能力”，而不是“我需要调 DB”。
