Builder 应持有抽象接口指针(如 std::unique_ptr<Product>),通过虚函数定义构建契约,由 ConcreteBuilder 负责具体实例化;Director 不传参数、不涉业务逻辑,仅顺序调用无参方法;链式调用须返回 Builder& 且由调用方管理生命周期;getResult() 应返回 std::unique_ptr&& 实现所有权转移。

Builder 类怎么设计才不和 Product 耦合
直接在 Builder 里 new Product 实例,等于把具体类型写死了,后续换实现或加 mock 就得改所有 builder。正确做法是让 Builder 持有抽象接口指针(比如 std::unique_ptr<productinterface></productinterface>),构造逻辑只调用虚函数,具体类由 ConcreteBuilder 在 build() 里 new。
常见错误现象:Builder 头文件里 #include 了具体 Product 的头,编译依赖爆炸,单元测试没法替换成 stub。
- 用纯虚基类定义构建契约,比如
virtual void set_name(const std::string&) = 0 -
ConcreteBuilder构造函数接收一个工厂函数或 factory 对象,避免内部 new - 如果 Product 是值语义且轻量,也可以用
std::optional<product></product>+ move 构造,但要注意拷贝成本
Director 和 Builder 之间要不要传参数
Director 不该知道任何字段名或业务规则,它只负责调用 builder->step1()、builder->step2() 这种无参方法。所有输入数据应该在 Director 外部准备好,通过 Builder 构造函数或独立的 configure() 方法注入。
否则会出现:Director 变成业务逻辑中枢,一改就崩;Builder 接口膨胀出一堆 set_xxx(int),失去封装性。
立即学习“C++免费学习笔记(深入)”;
- 推荐模式:
Director(director_config).construct(builder),其中director_config是结构体或 JSON 解析结果 - Builder 内部用成员变量暂存配置,每步操作只读不写外部状态
- 避免在
Director::construct()里做 if-else 分支决定调用哪个 step —— 那属于 Builder 的职责
如何支持部分构建和链式调用
链式调用本质是每个 setter 返回 *this,但 C++ 里容易踩两个坑:返回局部对象引用、生命周期错乱。真正安全的做法是让 Builder 方法返回 Builder&,且 Builder 必须由调用方管理生命周期(比如栈上创建)。
常见错误现象:auto b = Builder().name("a").age(12); 中 Builder() 临时对象在分号前就析构,后续调用野指针。
- 禁止返回临时 Builder 对象的引用,只允许返回已存在实例的引用
- 如果需要“部分构建后复用”,用
Builder::clone()返回新实例,而不是共享状态 - 考虑用
std::move支持右值链式:让Builder&&的方法返回Builder&&,避免不必要的拷贝
std::shared_ptr 还是 std::unique_ptr 管理 Product
绝大多数场景用 std::unique_ptr 更合适。Builder 的职责是“构建完成即交付”,不该保留对 Product 的长期引用;Director 或调用方拿到后自行决定所有权归属。
用 shared_ptr 容易掩盖资源归属问题,比如多个 Builder 共享同一 Product 导致意外修改,或者忘记 reset 引起悬挂指针。
- Builder 的
getResult()应该是std::unique_ptr<productinterface>&&</productinterface>,强制转移语义 - 如果 Product 必须被多个组件观察(比如日志、监控模块),由外部用
shared_ptr包一层,Builder 不参与 - 注意:不要在 Builder 里用
shared_ptr存自己构建的 Product,否则getResult()返回时可能触发循环引用











