本文详解如何使用 lombok 的 `@superbuilder` 注解，让子类 builder 正确继承并初始化父类（抽象）字段，彻底解决手动实现 builder 模式时字段不可见、构造器缺失等问题。
在基于继承的构建器模式（Builder Pattern）中，一个常见痛点是：子类无法自动访问或初始化父类中定义的字段。如问题所示，当 StringValidatorConfig 继承自抽象类 CommonValidatorConfig 且两者均含私有字段（canBeNull、canBeEmpty）时，手动编写的 Builder 会因字段不可见而无法正确构造实例；同时，@AllArgsConstructor（即使设为 PRIVATE）也不会包含父类字段——因为 Lombok 默认只处理当前类的直接字段，不递归继承。
此时，Lombok 提供的 @SuperBuilder 是专为此场景设计的解决方案。它能自动生成支持继承链的泛型 Builder 类，确保：
- 父类字段被子类 Builder 完整继承并可配置；
- 构造逻辑类型安全，无需 @SuppressWarnings("unchecked") 强转；
- 子类 Builder 可无缝调用父类 Builder 方法（如 canBeNull(true)），并最终正确组装完整对象。
✅ 正确用法：两步极简配置
只需为父类和子类分别添加 @SuperBuilder，其余交由 Lombok 处理：
@Getter
@SuperBuilder
public abstract class CommonValidatorConfig {
private boolean canBeNull;
private boolean canBeEmpty;
}
@SuperBuilder
public class StringValidatorConfig extends CommonValidatorConfig {
}
编译后，Lombok 将生成：
- CommonValidatorConfigBuilder（抽象基 Builder）；
- StringValidatorConfigBuilder（具体子类 Builder），自动继承所有父类字段的 setter，并重写 build() 返回 StringValidatorConfig 实例；
- 所有方法返回 this（即子类 Builder 自身），类型安全无强转。
? 扩展自定义逻辑（如 setDefault()）
若需添加自定义构建方法（如一键设置默认值），可在父类中显式声明 Builder 抽象类头，Lombok 会自动补全其余逻辑：
@Getter
@SuperBuilder
public abstract class CommonValidatorConfig {
private boolean canBeNull;
private boolean canBeEmpty;
// 显式声明 Builder 抽象类（Lombok 会继承并增强它）
public static abstract class CommonValidatorConfigBuilder> {
// 自定义方法：类型安全，返回 B（子类 Builder）
public B setDefault() {
this.canBeNull = false;
this.canBeEmpty = false;
return self(); // Lombok 自动生成 self() 方法，返回 B
}
}
}
? 提示：self() 是 @SuperBuilder 自动生成的模板方法，等价于 return (B) this;，但完全类型安全，无需手动强转。
⚠️ 注意事项与最佳实践
-
@SuperBuilder 目前标记为“experimental”，但已广泛用于生产环境；其核心逻辑稳定，仅维护响应可能略慢于 @Builder。官方计划将其提升为稳定特性。
避免混用 @Builder 和 @SuperBuilder：同一继承链中必须统一使用 @SuperBuilder，否则生成的 Builder 类型不兼容。
字段可见性无关紧要：@SuperBuilder 直接操作字段（非 getter/setter），因此父类字段即使为 private 也可被 Builder 访问。
-
如需审查生成代码：运行 lombok delombok 命令可导出实际生成的 Java 源码，便于调试或迁移：
java -jar lombok.jar delombok -p src/main/java/your/package/CommonValidatorConfig.java
✅ 总结
放弃手动实现泛型 Builder 的复杂嵌套与类型强转——@SuperBuilder 以声明式语法彻底解决继承式构建器的字段继承、类型安全与可扩展性问题。只需两行注解，即可获得工业级健壮的 Builder 链，代码更简洁、可读性更高、维护成本更低。对于任何含继承关系的配置类、DTO 或领域模型，@SuperBuilder 都应是首选方案。
