java lombok

### Java 中 Lombok 库的使用教程

#### 安装与配置
为了使项目能够利用 Lombok 提供的功能，开发者需先引入依赖项。对于 Maven 项目而言，在 `pom.xml` 文件内加入如下声明：

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.24</version>
    <scope>provided</scope>
</dependency>

接着要确保 IDE 已经正确安装了对应的插件支持，比如 IntelliJ IDEA 用户可以通过设置页面找到 Plugins 并搜索 "Lombok Plugin" 进行安装。

#### 基本注解介绍

- **@Getter/@Setter**
这些注解可以分别用来为类中的字段自动生成 getter 和 setter 方法。例如给定一个简单的实体类 `Person` 如下所示[^2]:

import lombok.Getter;
import lombok.Setter;

@Getter @Setter
public class Person {
    private String name;
    private int age;
}

此时无需再手动编写冗长的访问器方法定义。

- **@ToString**
此注解会基于当前对象的所有属性来自动生成 `toString()` 方法实现，极大地方便调试工作。

- **@EqualsAndHashCode**
该注解负责生成合理的 `equals(Object o)` 及 `hashCode()` 实现逻辑，默认情况下只会考虑非静态成员变量参与比较运算。

- **@NoArgsConstructor, @AllArgsConstructor, @RequiredArgsConstructor**
这组构造器相关的注解允许快速创建无参、全参数以及仅含必填项（final 或者带有 `@NonNull` 注解）的构造函数。

#### 解决常见问题

当遇到像 Getter 和 Setter 方法未被识别的问题时，通常是因为使用的 IDE 版本与 Lombok jar 包之间存在兼容性差异所致。这时建议尝试升级至最新的稳定版本并按照官方文档指引完成重新部署过程；一般只需简单替换旧文件即可，不必特意移除原有组件[^4]。