Lombok 注解在 VSCode 中不生效的根本原因是 JDT LS 未启用注解处理，导致无法感知 @Data 等生成的 getter/setter；需手动配置 "java.configuration.configureAnnotationProcessing": true 并点击「Import Changes」使设置生效。
Lombok 注解在 VSCode 中不生效，编译报错 The import lombok cannot be resolved 或字段/方法无补全 —— 根本原因不是代码写错了，而是字节码增强和 Language Server（JDT LS）没对齐。
为什么 Java 语言服务器看不到 @Data 生成的 getter/setter
VSCode 的 Language Support for Java（基于 Eclipse JDT LS）默认不启用注解处理器，它只解析源码 AST，不执行 Lombok 的字节码增强逻辑。即使你加了 @Data，JDT LS 仍认为那个类没有 getName() 方法，所以补全、跳转、重命名全部失效。
这不是插件没装、依赖没加的问题，而是「编译时行为」和「编辑器感知行为」脱节了：
- JDK 编译（
javac）靠-javaagent:lombok.jar触发字节码改写 - JDT LS 不走 javac 流程，它需要显式启用注解处理支持，并同步 Lombok agent 路径
- 如果只配了 Maven 依赖但没告诉 JDT LS “请用 Lombok 处理注解”，它就永远看不见生成的代码
必须配置 java.configuration.configureAnnotationProcessing
这个设置是开关，决定 JDT LS 是否加载并运行项目中的注解处理器（包括 Lombok）。不设为 true，所有 Lombok 注解在编辑器里都只是“装饰性符号”。
立即学习“Java免费学习笔记（深入）”；
操作方式：
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 打开项目根目录下的
.vscode/settings.json（没有就新建） - 添加这一行：
"java.configuration.configureAnnotationProcessing": true - 保存后，右下角会弹出「Import Changes」提示，**必须点它**，否则配置不生效
注意：不要只依赖插件自动检测 —— 某些旧版 vscode-java（Extension Pack for Java（含 Language Support for Java v1.40+）。
-javaagent 路径没对齐，Lombok 版本就白配
JDT LS 需要自己启动一个嵌入式 Java 进程来分析项目，它必须用和 Maven 构建一致的 Lombok agent 才能生成相同语义的 AST。常见断裂点：
- Maven 用
lombok:1.18.32，但 VSCode 启动 JDT LS 时用的是扩展内置的 1.18.24 —— 注解行为不一致，比如@RequiredArgsConstructor对final字段的处理逻辑可能有差异 - 手动下载了
lombok.jar放在D:\lib\lombok.jar，但settings.json里漏写了java.jdt.ls.vmargs，导致 JDT LS 进程根本没加载 agent
正确做法（推荐优先级从高到低）：
- 用 Maven 管理 Lombok → 确保
pom.xml里 scope 是provided，且版本 ≥1.18.24 - 在
.vscode/settings.json中强制指定 agent："java.jdt.ls.vmargs": "-javaagent:/path/to/lombok.jar"（Windows 路径用正斜杠或双反斜杠） - 执行
Clean Java Language Server Workspace命令（Ctrl+Shift+P），彻底清空缓存再重启
普通 Java 项目（非 Maven/Gradle）怎么让 Lombok 工作
没有 pom.xml 或 build.gradle，JDT LS 就无法自动发现 Lombok 依赖。这时必须人工把 Lombok jar 注册为“项目引用库”，并开启注解处理：
- 下载
lombok.jar（官网最新版，如 1.18.32） - 在
.vscode/settings.json中写两段关键配置："java.project.referencedLibraries": ["./lib/lombok.jar"]"java.configuration.configureAnnotationProcessing": true - 确保
./lib/lombok.jar路径真实存在，且文件可读 - 重启窗口或运行
Clean Java Language Server Workspace
别指望只放 jar 到 lib/ 目录下就自动生效 —— VSCode 的 Java 插件不会扫描任意目录，referencedLibraries 是唯一声明方式。
最常被忽略的一点：Lombok 的 @FieldNameConstants、@SneakyThrows 等高级注解，对 JDT LS 的版本敏感度远高于 @Data。如果你用了这些注解却没看到对应生成内容，大概率是 JDT LS 内置的 Lombok 支持版本太低，或者 -javaagent 指向了旧版 jar。
