IntelliJ IDEA配置Lombok插件教程

本文深入解析了 IntelliJ IDEA 中 Lombok 插件配置失效的常见痛点与根本原因——并非插件安装失败，而是 IDE 注解处理器未启用、项目依赖配置不匹配（如 Maven 的 scope 错误或 Gradle 缺少 annotationProcessor 声明）、缓存不同步及注解语义冲突等多层配置未对齐所致；文章手把手指导如何精准排查 @Getter/@Data 不生效、toString/equals 报红、Gradle 编译识别失败、Spring Boot 中 @Builder 与构造器注解冲突等典型问题，并给出重启策略、缓存清理、依赖写法修正及设计取舍建议，助你彻底告别“插件装了却没用”的困扰，让 Lombok 真正丝滑融入开发流程。

IDEA里Lombok插件装了但@Getter没生效

根本原因通常是插件启用后，IDEA没开启“注解处理器”或项目没正确识别Lombok依赖。不是插件没装好，而是两层配置没对齐。

检查步骤如下：

• 确认 Lombok Plugin 已在 Settings → Plugins 中启用（不是仅安装）
• 进入 Settings → Build → Compiler → Annotation Processors，勾选 Enable annotation processing
• 如果是 Maven 项目，确保 pom.xml 里有 Lombok 依赖，且 scope 不是 test：

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

• 重启 IDEA（不是重载项目，是彻底关闭再打开）——很多人卡在这一步

使用 @Data 时 toString() 或 equals() 报红或不生成

这是典型“编译期生成 vs 编辑器感知”不同步问题。Lombok 的方法只在编译时注入，IDEA 需要靠插件模拟语义，一旦缓存错乱就会报红，但实际编译通过。

常见诱因和对策：

• @Data 默认会生成 toString()、equals()、hashCode()，但如果类里已有同名方法（哪怕只是空实现），Lombok 就会跳过——删掉手写的冲突方法
• 如果用了 @EqualsAndHashCode(exclude = "field")，但字段名拼错，IDEA 插件无法推导，直接标红；检查 exclude 或 include 里的字段名是否真实存在且大小写一致
• 执行 Build → Rebuild Project 后仍报红？点 File → Invalidate Caches and Restart → Invalidate and Restart

Gradle 项目中 Lombok 注解不被编译器识别

Gradle 默认不开启 annotationProcessor 路径支持，即使加了依赖，javac 也看不到 Lombok 的 processor。

必须显式配置：

• 在 build.gradle（非 build.gradle.kts）中添加：

  dependencies {
      compileOnly 'org.projectlombok:lombok:1.18.30'
      annotationProcessor 'org.projectlombok:lombok:1.18.30'
      testCompileOnly 'org.projectlombok:lombok:1.18.30'
      testAnnotationProcessor 'org.projectlombok:lombok:1.18.30'
  }

• 用 Kotlin DSL（build.gradle.kts）则改用：

  compileOnly(libs.lombok)
  annotationProcessor(libs.lombok)

  ，并确保 libs.versions.toml 里定义了对应版本
• 不要用 implementation 替代 compileOnly + annotationProcessor：前者会让 Lombok 进入运行时 classpath，可能引发冲突

Spring Boot 项目里 @Builder 和 @AllArgsConstructor 冲突

当类同时有 @Builder 和 @AllArgsConstructor（或 @RequiredArgsConstructor），Lombok 可能生成重复构造器，导致编译失败或 Spring 无法注入。

这不是 bug，是设计使然——@Builder 默认生成一个全参私有构造器 + builder 方法，而 @AllArgsConstructor 又生成一个公有全参构造器。

解决方式很直接：

• 删掉 @AllArgsConstructor，让 @Builder 自己管理构造逻辑（推荐）
• 或者用 @Builder(access = AccessLevel.PACKAGE) 控制 builder 访问级别，避免与 Spring 构造器注入冲突
• 若必须保留全参构造器供 Spring 使用，改用 @RequiredArgsConstructor(onConstructor_ = @__(@Autowired)) 并配合 final 字段，更符合 Spring Boot 的惯用法

真正麻烦的是混合用了 Lombok 和手动写的构造器、字段初始化、@PostConstruct —— 这些时机和顺序 IDE 很难推断，建议这类类干脆不用 Lombok 生成构造逻辑，保持明确可控。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《IntelliJ IDEA配置Lombok插件教程》文章吧，也可关注golang学习网公众号了解相关技术文章。