Go项目分层应以internal为根目录，因其提供包级访问控制；domain层须零依赖，用自定义类型封装time.Time；application层只处理domain错误，infrastructure层负责错误转换与具体实现。
Go 项目不需要硬套 Clean Architecture，但如果你的业务逻辑开始变重、接口频繁变更、测试难写、改个数据库要动三层——说明分层失控了，这时候该用明确边界来约束依赖流向。
为什么 internal 目录比 pkg 更适合作为分层根目录
Go 官方推荐 internal 作为“仅本项目可导入”的私有模块存放地，它天然支持包级访问控制。而 pkg 是公开共享意图的，容易误导团队把领域逻辑暴露成 SDK；一旦暴露，后续重构就会受下游掣肘。
-
internal/domain：只放 struct、interface、纯函数（无外部依赖），比如User结构体和UserRepository接口 -
internal/application：实现 use case，依赖domain，但绝不 importinfrastructure或handlers -
internal/infrastructure：放数据库 driver、HTTP client、Redis 封装，实现domain中定义的 repository 接口 -
cmd和api（或handlers）放在顶层，只负责组装和启动，不放业务逻辑
application 层里不能出现 sql.ErrNoRows 这类基础设施错误
如果 use case 函数里写了 if errors.Is(err, sql.ErrNoRows)，说明你已经把 PostgreSQL 的错误语义泄漏到了应用层——这会让单元测试被迫引入真实 DB，也违背了“依赖抽象而非实现”原则。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 在
infrastructure实现中将sql.ErrNoRows转为自定义错误，如domain.ErrUserNotFound -
application层只处理domain包定义的错误类型，便于 mock 和断言 - HTTP handler 再把
domain.ErrUserNotFound映射为 404，保持错误语义逐层翻译
怎么让 domain 层真正“零依赖”，连 time.Time 都要小心
time.Time 看似无害，但它带有时区、格式化、计算等行为，一旦你在 domain 结构体里直接用它，就等于把标准库的时间处理逻辑耦合进核心模型——比如未来想换用 carbon 或做 deterministic 测试时会卡住。
立即学习“go语言免费学习笔记（深入）”；
- 用自定义类型封装时间字段：
type CreatedAt int64（Unix timestamp）或type CreatedAt string（ISO8601 字符串） - 所有时间生成、比较、格式化操作移至
application或infrastructure层 - 若必须保留
time.Time，至少定义一个TimeProviderinterface 并注入，避免直接调用time.Now()
最常被忽略的是依赖注入粒度：不是每个 struct 都要传满 5 个 repository，而是按 use case 组合最小接口。比如 CreateOrderUseCase 只需要 OrderRepository 和 PaymentClient，别把整个 infrastructure.DB 塞进去。
