intellij idea 中 lombok 插件不生效需确认三件事:安装启用插件、开启 annotation processing、构建工具中正确声明 compile 范围依赖;新版 lombok 1.18.32 与 jackson 兼容问题需显式配置 lombok.config;@builder 与 @allargsconstructor 同用易冲突,推荐 @requiredargsconstructor + @builder;单元测试中失效多因 test classpath 缺失 lombok 依赖或 ide 缓存未更新。

IntelliJ IDEA 里 Lombok 插件不生效?先确认这三件事
插件装了但 @Data 还是报错、字段没自动生成 getter/setter,大概率不是 Lombok 本身的问题,而是 IDE 层没打通。
- 必须安装并启用
Lombok Plugin(在 Settings → Plugins 搜索启用,重启 IDE) - 必须开启
Enable annotation processing(Settings → Build → Compiler → Annotation Processors → 勾选) - 项目用 Maven/Gradle 的话,
pom.xml或build.gradle里得有 Lombok 依赖,且 scope 是compile(不是provided或test)
Maven 中 Lombok 依赖写法差异:1.18.30 vs 1.18.32 的坑
新版 Lombok(如 1.18.32)默认启用 lombok.config 的 lombok.anyConstructor.addConstructorProperties = true,会导致 Jackson 反序列化失败——尤其在 Spring Boot 接收 JSON 请求体时抛 InvalidDefinitionException。
- 稳妥写法(显式锁定行为):
<dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>1.18.30</version> <scope>provided</scope> </dependency>
- 若坚持用新版本,需在模块根目录加
lombok.config文件,写入:lombok.anyConstructor.addConstructorProperties = false
-
scope=provided是对的,但得确保编译期能解析注解——IDEA 的 annotation processor 开关比这个 scope 更关键
@Builder 和 @AllArgsConstructor 同时用会冲突?看构造函数签名
当类既有 @Builder 又有 @AllArgsConstructor,Lombok 默认生成两个全参构造器:一个给 builder 内部用(带 $ 符号),一个公开的。如果字段含 final 或有 @NonNull,容易触发编译错误 constructor is already defined。
- 推荐组合:
@RequiredArgsConstructor+@Builder(只对final和@NonNull字段生成构造参数) - 避免同时用
@AllArgsConstructor和@Builder,除非你手动指定@Builder(toBuilder = true)并接受冗余构造器 - 如果必须全参,改用
@Builder(builderMethodName = "builder", buildMethodName = "create")避免方法名冲突
Lombok 在 Spring Boot 单元测试中失效?检查 test classpath
运行 @SpringBootTest 没问题,但纯 @ExtendWith(MockitoExtension.class) 测试里 @Data 不起作用,常见于使用了 lombok-mapstruct-binding 或测试模块没继承主模块 dependencyManagement。
立即学习“Java免费学习笔记(深入)”;
- 确认测试模块的
pom.xml显式声明了 Lombok 依赖(不能只靠 parent pom 传递) - IDEA 中右键测试类 → “Run ‘xxxTest’” 时,实际用的是 test classpath;而 Maven 命令行执行
mvn test通常没问题——说明是 IDE 缓存或 classpath 配置偏差 - 临时解决:在测试类上加
@Import(LombokConfig.class)(自定义空配置类)无用;真正有效的是 File → Invalidate Caches and Restart → “Clear file system cache and Local history”
最常被忽略的点:Lombok 注解的“可见性”取决于编译阶段是否完成处理,而这个阶段高度依赖 IDE 设置与构建工具的一致性。一旦出现行为不一致,优先查 annotation processor 开关和依赖 scope,而不是怀疑注解写错了。










