Facade 在 Go 中是通过包级函数组合实现的统一入口，而非经典面向对象的结构体封装；它聚焦高频共用操作的简化调用，强调职责收敛、错误直传与轻量协调。
Facade 是什么，为什么 Go 里不直接套用经典定义
Go 没有类继承、没有抽象接口强制约束，所谓“外观模式”不是靠结构体嵌套+接口实现的教科书式封装，而是靠包级职责收敛和函数组合达成的统一入口效果。硬搬 UML 图里的 SubsystemA、SubsystemB 结构，反而会让代码变重、耦合更隐晦。
真正该做的：把一组高频共用的操作（比如初始化数据库+加载配置+启动 HTTP 服务）抽成一个包内顶层函数，让调用方只关心“我要启动服务”，而不是“先调 NewConfig()，再传给 NewDB()，再塞进 Server{...}”。
常见错误现象：
- 在 facade.go 里大量复制粘贴子系统初始化逻辑，导致后续改一处要同步修五处
- 把所有子系统结构体全塞进 facade 结构体字段，结果 Facade 变成上帝对象，测试时不得不 mock 全家桶
- 用空接口或泛型强行统一返回，掩盖了各子系统真实的错误类型，调试时只能看到 interface {} is nil
怎么写一个实用的 Go Facade 函数（不是结构体）
优先用函数，不是结构体。Go 的包天然就是命名空间，app.Start() 比 f := NewFacade(); f.Start() 更轻、更易测、更符合 Go 习惯。
- 入口函数接受明确参数：比如
configPath string、env string，而不是一个万能options ...Option切片（除非真有十几个可选配置） - 内部按顺序调用子系统初始化函数，每一步都检查错误，立刻返回——不要攒到最后统一处理
- 子系统初始化函数自己负责资源清理（比如失败时关闭已打开的 DB 连接），Facade 不越界管理生命周期
- 返回值聚焦业务语义：比如
func Start(configPath string) (*App, error)，其中*App是一个轻量协调器，只持有必要句柄，不封装子系统全部方法
示例：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
func Start(configPath string) (*App, error) {
cfg, err := loadConfig(configPath)
if err != nil {
return nil, err // 不包装，保留原始错误上下文
}
<pre class="brush:php;toolbar:false;">db, err := newDB(cfg.DBURL)
if err != nil {
return nil, err
}
httpSrv := newHTTPServer(cfg.Addr, db)
return &App{
DB: db,
Srv: httpSrv,
}, nil}
子系统初始化函数该怎么设计才不破坏 Facade 的简洁性
子系统函数必须是“自洽”的：能独立运行、有清晰输入输出、错误可预测。否则 Facade 会变成错误黑洞。
- 每个子系统初始化函数名用
NewXxx()或InitXxx()，避免用SetupXxx()这种模糊动词 - 参数尽量少：DB 初始化只收
url string和可选*sql.DB（用于测试注入），别把日志器、监控器、超时控制全塞进来 - 返回具体错误类型（如
*url.Error、pgconn.ConnectError），别统一转成fmt.Errorf("failed to init db") - 不共享状态：子系统之间通过参数传递依赖，而不是读取全局变量或单例，否则 Facade 无法并发安全地多次调用
容易踩的坑：
- NewDB() 内部偷偷初始化了一个全局 log.Logger，结果 Facade 并发启动两个实例时日志混在一起
- InitCache() 返回 nil, nil 表示“跳过”，但 Facade 没检查就继续往下走，导致后续 panic
什么时候不该用 Facade，或者该砍掉它
Facade 的价值在于降低认知负荷，不是增加抽象层数。以下情况直接删掉 Facade 层更干净：
- 整个程序只有 3 个函数，且调用关系线性简单（main → initDB → startServer）
- 子系统之间没有强依赖，比如 CLI 工具里，配置加载和命令执行完全解耦，硬套 Facade 反而让 main 包依赖了本不该依赖的 HTTP 模块
- 你发现 Facade 函数里开始出现 if/else 分支逻辑（比如根据环境切换 DB 驱动），说明它已超出“统一入口”范畴，正在变成流程控制器——这时该拆成多个专用启动函数，如
StartDev()、StartProd()
最常被忽略的一点：Facade 函数的测试覆盖率往往被低估。它不包含业务逻辑，但串联逻辑一旦出错（比如漏关连接、错序初始化），问题会出现在集成阶段，很难定位。务必为 Facade 写至少一个端到端测试，用临时目录、随机端口、内存数据库跑通全流程。
