先开启注解处理器：file → settings → build → compiler → annotation processors 勾选 enable annotation processing，并勾选 obtain processors from project classpath；再确认 maven 依赖含 provided 且版本为 1.18.30+。
插件装了但 @Data 还是标红？先开注解处理器
装完 Lombok 插件不等于能用，IDEA 默认关闭注解处理——这是 90% 新手卡住的第一步。没开这个开关，@Data、@Slf4j 在编辑器里直接报红，编译也过不去。
操作路径：File → Settings → Build, Execution, Deployment → Compiler → Annotation Processors，必须勾选 Enable annotation processing。
- 如果项目是 Maven/Gradle，还要勾选
Obtain processors from project classpath，否则 IDEA 不会读取你pom.xml或build.gradle里的 Lombok 依赖 - Windows/Linux 快捷键是
Ctrl+Alt+S，macOS 是Cmd+, - 改完设置不用重启 IDEA，但必须执行
Build → Rebuild Project才能生效 - 多 module 项目，每个 module 都得单独检查这个开关是否开启
Maven 项目缺 lombok 依赖，编译直接失败
插件只负责让 IDEA 识别注解、提供代码提示；真正编译时注入 getter/setter 的，是 lombok 库本身。缺依赖，编译报错类似：cannot find symbol method getName()。
pom.xml 中必须写成这样：
<dependency><groupid>org.projectlombok</groupid><artifactid>lombok</artifactid><version>1.18.30</version><scope>provided</scope></dependency>
-
<scope>provided</scope>很关键：告诉 Maven 这个依赖只在编译和测试期需要，运行时不打包——避免和 Spring Boot 内嵌容器冲突 - 别用老版本（比如
1.16.x），2026 年主流环境（JDK 17+、IDEA 2023.3+）建议用1.18.30或更高 - Gradle 用户对应写法是：
compileOnly 'org.projectlombok:lombok:1.18.30'+annotationProcessor 'org.projectlombok:lombok:1.18.30'
离线安装插件时，别解压 ZIP 文件
公司内网或网络受限环境无法访问 Marketplace，就得手动下载插件 ZIP。常见错误是把 ZIP 解压成文件夹再试图“安装文件夹”，结果 IDEA 报错：Plugin 'Lombok' is incompatible with this installation。
正确做法：
- 去 JetBrains 插件市场页面 下载最新版
Lombok插件 ZIP（注意匹配你的 IDEA 版本） -
File → Settings → Plugins → ⚙️ → Install Plugin from Disk，直接选中 ZIP 文件（不是解压后的文件夹） - 安装后重启 IDEA
用了 @SuperBuilder 却不生效？查 lombok-experimental
@SuperBuilder 属于实验性功能，默认不包含在主 lombok 包中。即使插件和主依赖都配好了，IDEA 仍可能不识别该注解或生成代码异常。
解决方法是在 pom.xml 中额外加一行：
<dependency><groupid>org.projectlombok.experimental</groupid><artifactid>lombok-experimental</artifactid><version>1.18.30</version></dependency>
- 版本号必须和主
lombok一致，否则可能引发类加载冲突 - 部分旧版 IDEA（如 2022.x）对
@SuperBuilder支持不稳定，建议升级到 2023.3+ 并配最新插件
最常被忽略的其实是模块级配置：哪怕全局开关开了，某个 module 没勾选注解处理器，或者它的 lombok 依赖 scope 写成了 compile 而非 provided，都会导致局部失效。遇到问题先看具体 module 的设置，而不是怀疑插件或版本。
