Lombok注解详解：从朴素构造到高效开发

初识Lombok：解放双手的开始

记得刚开始写Java的时候，每次创建实体类都要写一大堆getter、setter、toString方法，手都敲酸了。后来发现了Lombok这个小工具，简直像是打开了新世界的大门。它通过注解的方式帮我们自动生成这些样板代码，让开发变得轻松多了。

基础注解：从@Getter/@Setter说起

最基础的注解莫过于@Getter和@Setter了。想象一下，你有个User类，有5个字段，手动写getter和setter要写10个方法。用了这两个注解后，只需要在类上标注一下，Lombok就会在编译时自动生成这些方法。

java 复制代码

@Getter
@Setter
public class User {
    private String name;
    private int age;
    // 其他字段...
}

这样写确实省事，但有个小问题：如果有些字段不需要setter怎么办？比如ID字段通常不希望被修改。这时候可以只在类上标注@Getter，然后在需要setter的字段上单独标注@Setter。

构造方法的进化：@NoArgsConstructor和@AllArgsConstructor

接下来是构造方法相关的注解。@NoArgsConstructor会生成无参构造，@AllArgsConstructor会生成包含所有字段的构造方法。

java 复制代码

@NoArgsConstructor
@AllArgsConstructor
public class Product {
    private Long id;
    private String name;
    private BigDecimal price;
}

但这里有个潜在问题：有些字段是必须的，比如产品名称和价格，而ID可能是数据库自动生成的。用@AllArgsConstructor会让所有字段都变成可选的，这不太符合业务逻辑。

更智能的构造：@RequiredArgsConstructor

这时候@RequiredArgsConstructor就派上用场了。它会为所有final字段和带有@NonNull注解的字段生成构造参数。

java 复制代码

@RequiredArgsConstructor
public class Order {
    private final Long id;  // 由数据库生成
    @NonNull private String orderNo;
    @NonNull private Customer customer;
    private String remark;  // 可选字段
}

@RequiredArgsConstructor的注意事项

final字段自动包含 ：任何final字段都会被自动包含在生成的构造器中，无论是否有@NonNull注解。这是Java语言本身的特性决定的 - final字段必须在构造器中初始化。
与Spring的完美配合 ：当类上有Spring的注解如@Service时，Spring会特别处理这个构造器，进行依赖注入。

java 复制代码

@Service
@RequiredArgsConstructor
public class ProductService {
    private final ProductMapper productMapper;  // 自动注入
    private final Cache<Long, Product> productCache;  // 自动注入
    
    // 即使没有@NonNull也能注入
}

与@NonNull的区别 ：@NonNull主要用于非final字段，表示该字段不能为null；而final字段本身就隐含了不能为null的语义。
同类型多个bean问题 ：如果有多个同类型的bean，需要配合@Qualifier注解使用。

对象完整性的保障：@Data和@Value

@Data可能是最常用的注解了，它相当于@Getter + @Setter + @ToString + @EqualsAndHashCode + @RequiredArgsConstructor的组合。

java 复制代码

@Data
public class Employee {
    private Long id;
    private String name;
    private Department department;
}

但@Data生成的setter会让所有字段都可修改，这在某些场景下不太安全。这时候可以考虑@Value，它生成的类是不可变的（所有字段都是final的），适合值对象。

java 复制代码

@Value
public class Point {
    int x;
    int y;
}

日志记录简化：@Slf4j

开发中经常需要记录日志，手动创建Logger对象也挺烦的。@Slf4j可以帮你自动生成Logger字段。

java 复制代码

@Slf4j
public class OrderService {
    public void createOrder(Order order) {
        log.info("Creating order: {}", order);
        // 业务逻辑
    }
}

构建器模式：@Builder

对于有很多可选参数的类，构造方法会变得很臃肿。这时候@Builder就能派上用场，它实现了建造者模式。

java 复制代码

@Builder
public class Computer {
    private String cpu;
    private String memory;
    private String disk;
    private String gpu;
}

// 使用方式
Computer myPC = Computer.builder()
    .cpu("i7")
    .memory("16GB")
    .disk("512GB SSD")
    .build();

这种方式特别适合配置类，可以清晰地看到每个参数的含义，而且可以只设置需要的参数。

空指针防护：@NonNull

@NonNull可以帮我们在编译期检查空指针问题。当标注了@NonNull的参数传入null时，Lombok会抛出NullPointerException。

java 复制代码

public void process(@NonNull String input) {
    // 方法体
}

懒加载：@Getter(lazy=true)

对于计算成本高的字段，可以使用懒加载。

java 复制代码

public class HeavyResource {
    @Getter(lazy=true)
    private final Map<String, String> cachedData = initCache();
    
    private Map<String, String> initCache() {
        // 耗时的初始化操作
    }
}

这样只有在第一次访问cachedData时才会执行初始化。

Lombok使用时的常见陷阱

过度使用@Data ：@Data会生成所有字段的equals和hashCode方法，可能导致集合操作异常。
继承问题 ：@EqualsAndHashCode和@ToString默认不会考虑父类字段，需要显式设置callSuper=true。
与JPA/Hibernate的冲突：实体类中使用Lombok时要小心懒加载问题。
构造器注入的混淆 ：记住@RequiredArgsConstructor会包含所有final字段，不仅仅是@NonNull字段。
泛型擦除问题：Spring对泛型的处理有时会有意外，特别是复杂的泛型组合。
版本兼容性：不同版本的Lombok可能有行为差异，团队要保持版本一致。
IDE支持：必须安装Lombok插件，否则代码会显示错误。

实际开发中的选择

在实际项目中，我通常会这样组合使用： • 对于实体类：@Data + @Builder（需要可变时）或@Value（需要不可变时） • 对于服务类：@Slf4j + @RequiredArgsConstructor（配合Spring的依赖注入） • 对于配置类：@Builder • 对于工具类：@UtilityClass（确保不能实例化）

总结

Lombok通过减少样板代码让Java开发变得更高效。合理使用这些注解，可以让我们把精力集中在业务逻辑上，而不是重复的编码工作上。关键是要：

理解每个注解的实际行为，特别是像@RequiredArgsConstructor这样的复合注解
根据业务场景选择合适的注解组合
注意可能遇到的陷阱，特别是在团队协作环境中
保持Lombok版本和IDE插件的一致性