# lombok-source

**Repository Path**: Hoysing/lombok-source

## Basic Information

- **Project Name**: lombok-source
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-30
- **Last Updated**: 2025-12-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Lombok 源码项目

### 项目简介

本项目修改自 Lombok 的官方源码，版本为`1.18.24`，并将其构建工具从原有的Ant迁移至Gradle，旨在提供一个便于快速调试Lombok源码、理解其注解处理机制以及进行功能演示的环境。通过本项目，开发者可以直观地体验Lombok如何通过注解在编译时生成代码，并深入探索其内部实现原理。

项目特色:
- 快速构建: 使用Gradle进行依赖管理和构建配置，配置了正确的注解处理器路径（annotationProcessor）以确保Lombok源码的编译和生成代码功能正常。

- 可调试性: 项目结构清晰，方便在IDE中直接对Lombok源码进行断点调试，跟踪注解处理过程。

- 代码精简: 为求代码精简，去除了JDK 8之外的其它版本，去除了对Eclipse编译器的处理逻辑。


### 快速开始

#### 环境准备

1. 确保已安装 JDK 8。

2. 确保已安装Gradle。

3. 推荐使用 IntelliJ IDEA。

4. 推荐安装并启用 Lombok插件。

#### 运行项目

1. 克隆项目:
```
git clone https://gitee.com/Hoysing/lombok-source
cd lombok-source
```

2. 构建:
``` 
gradlew build
```

3. 运行:
```
gradlew run
```

#### 调试源码

1. 在IDE中打开项目。

2. 在Lombok源码（例如`lombok.javac.handlers.HandleGetter`）中设置断点。

3. 以Debug模式运行演示程序`LombokDemo`。

4. 当程序执行到断点处时，即可逐步调试，观察Lombok如何分析和修改抽象语法树（AST）。


### 常见问题排查 (FAQ)

- IDE中无法识别Lombok注解，确认已安装并启用IDE的Lombok插件。

- 构建失败，检查网络连接，确保依赖能正常下载，检查JDK版本是否符合要求。

- 运行失败，尝试清理并重建项目，即执行`gradlew clean build`命令。

### 参与贡献

欢迎提交Issue和Pull Request来完善此调试环境或增加新的演示案例。

### 鸣谢

感谢Lombok项目团队及其所有贡献者提供了如此优秀的工具。

Happy Coding & Debugging!