Lombok 注解处理器原理

Lombok 的核心原理是通过 编译时注解处理 修改 Java 的 抽象语法树（AST），在编译阶段动态生成代码，而非运行时反射。以下是其实现原理的逐步解析：

---

1. 注解处理入口

Java 编译器（javac）在编译过程中会调用注解处理器（APT）。Lombok 实现了 javax.annotation.processing.Processor 接口，注册为注解处理器。当编译器检测到 Lombok 注解（如 @Getter）时，会调用 Lombok 的处理器。

---

2. 修改抽象语法树（AST）

Lombok 的核心操作是直接修改 Java 的 AST：

• AST 访问：通过 Java Compiler Tree API（com.sun.source.util.Trees）访问当前编译单元的 AST。
• 节点注入：识别目标类/字段上的 Lombok 注解后，向 AST 注入新节点（如生成 Getter 方法）。

例如，对于以下代码：

@Getter 
public class User {
    private String name;
}

Lombok 会向 AST 注入一个等效的方法节点：

public String getName() { 
    return this.name; 
}

---

3. 字节码生成

编译器基于修改后的 AST 生成字节码（.class 文件），最终效果等价于手动编写了目标代码：

User.class 反编译结果：
public class User {
    private String name;
    public String getName() { ... } // 由 Lombok 注入
}

注意：源代码文件（.java）本身不会被修改，仅编译结果（.class）发生变化。

---

4. 关键技术依赖

• JSR 269：基于 Java 的可插拔注解处理 API，提供编译时处理能力。
• 编译器内部 API：依赖 com.sun.tools.javac 包访问 AST（需开启 -XDenableSunApiLaxControl 等参数）。
• Agent 机制（可选）：部分 IDE 通过 Lombok Agent 实时解析 AST，实现编辑器的代码提示支持。

---

5. 与纯 APT 的区别

传统注解处理器（如 MapStruct）仅能 生成新文件，无法修改现有类的 AST。Lombok 通过突破 JSR 269 限制，直接操作 AST，实现了“无痕”代码注入。

---

示例：Lombok 处理流程

graph LR
A[源代码 .java] --> B[javac 编译器]
B --> C{检测 Lombok 注解}
C -->|是| D[Lombok 处理器修改 AST]
C -->|否| E[常规编译]
D --> F[生成修改后的 AST]
F --> G[输出 .class 字节码]

注意事项

1. 编译依赖：需在构建工具（Maven/Gradle）中配置 Lombok 依赖。
2. IDE 支持：需安装 Lombok 插件以正确解析生成的代码。
3. 局限性：过度使用可能降低代码可读性，且对 AST 的直接操作存在兼容性风险（如 JDK 升级时）。

通过此机制，Lombok 在编译期高效消除了冗余代码（如 Getter/Setter），同时保持源代码的简洁性。