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。依赖箭头永远指向抽象层。
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
避免跨包直接使用 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 用于本地快速验证）。
真正难的不是目录怎么建，而是每次新增一个包时，能否清晰回答三个问题：它依赖谁？谁依赖它？它的变更会影响哪些地方？答不上来，就是边界没划清。
