Golang怎么实现优雅的项目分层架构_Golang如何按照Clean Architecture组织代码【指南】-Golang-PHP中文网

Go项目分层应以internal为根目录，因其提供包级访问控制；domain层须零依赖，用自定义类型封装time.Time；application层只处理domain错误，infrastructure层负责错误转换与具体实现。

golang怎么实现优雅的项目分层架构_golang如何按照clean architecture组织代码【指南】

Go 项目不需要硬套 Clean Architecture，但如果你的业务逻辑开始变重、接口频繁变更、测试难写、改个数据库要动三层——说明分层失控了，这时候该用明确边界来约束依赖流向。

为什么 `internal` 目录比 `pkg` 更适合作为分层根目录

Go 官方推荐 internal 作为“仅本项目可导入”的私有模块存放地，它天然支持包级访问控制。而 pkg 是公开共享意图的，容易误导团队把领域逻辑暴露成 SDK；一旦暴露，后续重构就会受下游掣肘。

internal/domain：只放 struct、interface、纯函数（无外部依赖），比如 User 结构体和 UserRepository 接口
internal/application：实现 use case，依赖 domain，但绝不 import infrastructure 或 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 测试时会卡住。

用自定义类型封装时间字段：type CreatedAt int64（Unix timestamp）或 type CreatedAt string（ISO8601 字符串）
所有时间生成、比较、格式化操作移至 application 或 infrastructure 层
若必须保留 time.Time，至少定义一个 TimeProvider interface 并注入，避免直接调用 time.Now()

最常被忽略的是依赖注入粒度：不是每个 struct 都要传满 5 个 repository，而是按 use case 组合最小接口。比如 CreateOrderUseCase 只需要 OrderRepository 和 PaymentClient，别把整个 infrastructure.DB 塞进去。