17370845950

Go包设计核心是隔离变化、控制依赖流向、预留升级路径；应按抽象层级分domain/、infrastructure/、application/、transport/四层，接口置于domain层，DTO隔离传输层与实现，依赖注入显式可控。

Go 语言本身不强制包结构规范，但可扩展性差的包设计往往在项目增长后引发大量重构——核心问题不是“怎么组织目录”，而是“如何隔离变化、控制依赖流向、预留升级路径”。

按职责边界而非功能类型划分包

常见错误是把所有 user 相关逻辑塞进 user/ 包：模型、HTTP handler、数据库操作、校验规则混在一起。一旦要支持 gRPC 或 CLI 入口，就得复制粘贴或加条件编译。

正确做法是按抽象层级切分：

• domain/user：只含 User 结构体、核心业务方法（如 Validate()）、领域接口（如 UserRepository）
• infrastructure/user：实现 UserRepository，含 GORM 或 SQLx 的具体代码
• application/user：用例逻辑（如 CreateUser），依赖 domain/user 和 infrastructure/user，但不依赖 HTTP 或框架
• transport/http/user：仅处理请求解析、响应序列化，调用 application/user

这样新增 gRPC 接口只需加 transport/grpc/user，完全不影响其他层。

接口定义必须放在被依赖方，而非实现方

如果把 UserRepository 接口定义在 infrastructure/user，application/user 就得 import 该包，导致应用层被迫依赖基础设施细节——这是依赖倒置失败的典型表现。

必须把接口放在 domain/user，让 infrastructure/user 实现它：

package domain

type UserRepository interface {
    Save(u *User) error
    FindByID(id string) (*User, error)
}

application/user 只 import domain/user，infrastructure/user 则 import domain/user + gorm.io/gorm。依赖箭头永远指向抽象层。

避免跨包直接使用 concrete 类型

当 transport/http/user 直接返回 infrastructure/user.UserModel（GORM 模型）时，前端字段变更或数据库迁移会立刻波及 HTTP 层，失去控制权。

每个 transport 层应定义自己的 DTO：

• transport/http/user/user_dto.go：含 UserResponse、CreateUserRequest
• application/user 返回 domain/user.User
• 转换逻辑写在 transport 层内，不暴露给上层

这样数据库字段重命名、增加审计字段、拆分表，都只需改 infrastructure 层和 transport 层的映射，application 和 domain 完全不动。

初始化顺序与依赖注入需显式可控

用全局变量或 init() 函数隐式初始化 DB、Redis 客户端，会导致测试困难、环境切换僵硬、无法按需启用模块。

推荐显式构建依赖树：

func NewApp(cfg Config) (*App, error) {
    db := sql.Open(...)
    userRepo := infrastructure.NewUserRepo(db)
    userSvc := application.NewUserService(userRepo)
    httpHandler := transport.NewUserHTTPHandler(userSvc)

    return &App{
        UserHandler: httpHandler,
        DB:          db,
    }, nil
}

所有依赖通过参数传入，便于单元测试 mock，也方便在不同环境（dev/staging/prod）注入不同实现（比如内存版 repo 用于本地快速验证）。

真正难的不是目录怎么建，而是每次新增一个包时，能否清晰回答三个问题：它依赖谁？谁依赖它？它的变更会影响哪些地方？答不上来，就是边界没划清。