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,完全不影响其他层。
立即学习“go语言免费学习笔记(深入)”;
接口定义必须放在被依赖方,而非实现方
如果把 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。依赖箭头永远指向抽象层。
Destoon B2B网站管理系统是一套完善的B2B(电子商务)行业门户解决方案。系统基于PHP+MySQL开发,采用B/S架构,模板与程序分离,源码开放。模型化的开发思路,可扩展或删除任何功能;创新的缓存技术与数据库设计,可负载千万级别数据容量及访问。 系统特性1、跨平台。支持Linux/Unix/Windows服务器,支持Apache/IIS/Zeus等2、跨浏览器。基于最新Web标准构建,在
避免跨包直接使用 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 用于本地快速验证)。
真正难的不是目录怎么建,而是每次新增一个包时,能否清晰回答三个问题:它依赖谁?谁依赖它?它的变更会影响哪些地方?答不上来,就是边界没划清。









