Lombok封装实体类核心是两步:安装并启用IDEA插件(勾选Plugins中Lombok且重启)、添加Maven provided依赖(如1.18.34版本),再用@Data等注解即可自动生成getter/setter等代码。

Java 中封装实体类用 Lombok 很简单,核心就两步:装插件 + 加依赖,之后加注解就能自动生成 getter、setter、构造器等代码。
IDEA 插件安装与启用
IntelliJ IDEA 需要显式支持才能识别 Lombok 注解生成的方法,否则会报 cannot resolve method 错误。
- 打开 Settings → Plugins,搜索 “Lombok”,点击 Install 并重启 IDEA
- 进入 Settings → Build, Execution, Deployment → Compiler → Annotation Processors,勾选 Enable annotation processing
- 验证是否生效:新建一个类,加上
@Data,能正常调用getXxx()和setXxx()就说明成功了
Maven 项目引入依赖
Lombok 只在编译期起作用,运行时不需要,所以 <scope> 推荐设为 provided 或 compileOnly(Gradle)。
在 pom.xml 中添加:
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记(深入)”;
<dependency><groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.34</version>
<scope>provided</scope>
</dependency>
注意:Spring Boot 3.x 项目中,starter 通常不自带 Lombok,必须手动引入;高版本 JDK(如 JDK 21/22)建议用 1.18.34+,兼容性更稳。
常用注解怎么用
实体类上加几个注解,就能覆盖大部分封装需求:
-
@Data:最常用,等于@Getter + @Setter + @ToString + @EqualsAndHashCode + @RequiredArgsConstructor,适合普通 DTO、Entity 类 -
@NoArgsConstructor和@AllArgsConstructor:MyBatis、JPA 等框架依赖无参构造器,建议和@Data搭配使用,避免反射失败 -
@Accessors(chain = true):让 setter 返回this,支持链式调用,比如user.setName("张三").setAge(25) - 单字段控制:可在某个字段上单独加
@Getter或@Setter,实现读写权限分离
常见问题提醒
不是所有情况都“一注解万事大吉”:
- 如果用了
@Builder,默认不生成无参构造器,记得补上@NoArgsConstructor - 继承父类时,
@EqualsAndHashCode默认不包含父类字段,需加callSuper = true - 日志场景可搭配
@Slf4j,自动声明private static final Logger log - Lombok 不生成
serialVersionUID,如需序列化兼容,得手动加或用@Serial

















