java record 的 `@with` 注解仅生成单字段 with 方法，但可通过链式调用组合多个 `withx()` 方法高效更新多个字段；必要时可封装自定义组合方法，兼顾灵活性与可读性。
在使用 Lombok 的 @With 注解为 Record 生成不可变更新方法时，系统默认只为每个字段生成独立的 withX() 方法（如 withId()、withX()、withY()），不会自动合成多参数版本（如 withIdXY(Long, String, String)）。这并非限制，而是设计上的有意取舍——它遵循函数式编程中“小而专、可组合”的原则。
✅ 正确做法：优先使用链式调用
由于每个 withX() 方法均返回新实例且语义明确，多个字段更新可自然组合：
DepotRecord original = new DepotRecord(1L, "old-x", "old-y", "old-z", "old-a");
DepotRecord updated = original.withId(2L).withX("new-x").withY("new-y");该写法简洁、无副作用、线程安全，且编译期类型安全——IDE 可完整提示、编译器可校验字段名与类型。
? 进阶：按需封装组合方法（推荐用于高频场景）
若某组字段更新频繁出现（如 ID + 坐标 x/y 总是一起变更），可手动添加清晰命名的组合方法，提升 API 可读性与复用性：
@Builder
@With
public record DepotRecord(Long id, String x, String y, String z, String a) {
// 自定义多字段更新方法（不破坏不可变性）
public DepotRecord withIdXY(Long id, String x, String y) {
return this.withId(id).withX(x).withY(y);
}
// 可进一步支持部分字段忽略（如只更新 x/y，保留原 id）
public DepotRecord withXY(String x, String y) {
return this.withX(x).withY(y);
}
}⚠️ 注意事项：
- 避免重复构造：withIdXY() 内部应复用已有 withX() 等方法，而非直接 new DepotRecord(...) —— 否则绕过 Lombok 生成逻辑，易因字段增减导致维护断裂；
- 保持语义一致性：组合方法名应体现业务含义（如 withLocation() 比 withIdXY() 更佳，若 x/y 代表坐标）；
- 不建议生成全排列：Lombok 不提供 @With(multi = true) 等扩展，也不应手动实现所有 withAB()/withAC()/withABC() —— 组合爆炸违背 API 设计简洁性原则。
? 总结：
Lombok 的 @With 是“乐高积木”，而非“预装模型”。与其等待框架覆盖所有组合，不如善用链式调用构建所需状态，并在关键路径上通过语义化封装降低认知成本。这既保障了扩展性，又让代码意图一目了然。
