Java项目使用Lombok需同时引入依赖并安装IDE插件:Maven中添加provided作用域依赖,IDEA中安装Lombok插件并启用注解处理,验证@Data等注解生效且无编译错误。

在Java项目中使用Lombok,核心是两步:在项目中引入Lombok依赖,并在IDE中安装对应插件以支持注解的实时解析与代码补全。缺一不可,否则会出现编译报错或IDE提示“找不到符号”。
添加Lombok依赖(Maven)
在pom.xml中加入以下依赖(推荐使用最新稳定版,如1.18.32):
- 确保
设为provided,因为Lombok只在编译期起作用,运行时不需要 - 若用Gradle,对应写法为:
compileOnly 'org.projectlombok:lombok:1.18.32'+annotationProcessor 'org.projectlombok:lombok:1.18.32' - 添加后执行
Maven → Reload project,让IDE识别新依赖
在IDEA中安装并启用Lombok插件
IntelliJ IDEA默认不内置Lombok支持,需手动安装插件并开启注解处理:
- 打开Settings → Plugins,搜索“Lombok”,点击Install
- 重启IDEA
- 进入Settings → Build → Compiler → Annotation Processors,勾选
Enable annotation processing - (可选但推荐)勾选
Obtain processors from project classpath,避免手动配置路径
验证是否生效
新建一个简单类,加上@Data,观察效果:
立即学习“Java免费学习笔记(深入)”;
@Data
public class User {
private String name;
private int age;
}
- 鼠标悬停在类名上,应能看到自动生成的
toString()、equals()等方法提示 - 在其他地方调用
user.getName()或user.toString(),不应报红 - 编译运行成功,且日志中无Lombok相关错误
常见问题速查
如果仍报错,优先检查这几项:
- Lombok版本与JDK版本兼容(JDK 17+建议用1.18.30以上)
- IDEA是否启用了“Build project automatically”(部分旧版需开启才能触发注解处理)
- 模块是否被正确识别为Java模块(右键目录 →
Mark as Sources Root) - 有无与其他插件冲突(如MapStruct、Delombok等,可临时禁用排查)
基本上就这些。配置一次,后续新建项目复制依赖+插件即可复用,不复杂但容易忽略某一步。










