配置注解处理器
您可以配置 IntelliJ IDEA 以在编译期间处理自定义注解。 在编译时生成代码以处理注解的过程称为 Annotation Processing。
注解处理器可以根据注解验证、生成和修改您的代码,这将大大减少您需要编写的代码量。 注解处理器可以存储在您的项目内。 在这种情况下,IntelliJ IDEA 从 classpath 获取它。 如果注解处理器存储在项目外部,则需要手动添加注解处理器 JAR 的路径。
通过在 Maven 或 Gradle 项目中通过构建脚本添加注解处理器时,IntelliJ IDEA 会自动启用注解处理,并在注解处理器设置中添加适当的路径。
注解处理配置文件
注解配置文件 是一组用于注解处理的配置选项。 选项包括注解处理输出的位置、特定注解处理器及其参数。
默认配置文件始终存在。 项目包含的所有模块都使用默认配置文件。 您可以创建一个新配置文件,将多个模块归入其中,并为指定的模块组配置注解处理。
配置注解配置文件
按 Ctrl+Alt+S 打开设置,然后选择 。
在 注解处理器 页面上,点击页面底部的
。
在 创建新配置文件 对话框中,指定配置文件名称。

要将模块移动到创建的配置文件中,请选择您需要的模块,点击
(F6 )并选择目标配置文件。
为配置文件配置注解处理
请选择所需的注释配置文件。
请选择 启用注解处理 并配置以下选项:
从项目类路径获取处理器 :如果您在项目中使用自定义注解处理器,或者处理器作为库存储在附加到所有相应模块的 .jar 文件中,请保持此选项启用。
处理器路径 :选择此选项并指定注解处理器的路径,如果它存储在项目之外。
如果 Gradle 项目在 build.gradle 文件中指定了
annotationProcessor依赖项,此字段将包含导入 Gradle project 时 Gradle 使用的注解处理器的路径。 当您使用 Gradle 构建此类项目时,IntelliJ IDEA 会在 build 目录中的 项目 工具窗口内生成适当的子目录。
对于 Maven 项目 ,该字段将包含在 pom.xml 中指定的注解处理器路径。
请使用 --processor-module-path 编译器选项(适用于 java 9 及更高版本) :假设指定的路径是模块路径:包含已打包 Java 模块的 JAR 文件或目录的路径。 为了从模块路径发现和运行,注解处理器应打包为 Java 模块并在模块声明中通过 ServiceLoader进行注册。
将生成的来源存储为相对路径 :使用 模块输出目录 和 模块内容根目录 选项定义注解处理器生成的源文件的存储位置,并覆盖配置文件的默认行为。
生产源 和 测试源 :使用这些字段来指定注解处理器输出将要存储的目录名称。 如果该字段留空,注解处理器生成的文件将存储在项目输出目录下。 指定名称时,在内容根目录下会在自动注解处理后创建一个具有此名称的目录。
处理器 FQ 名称 :指定处理器要启动的完全限定名称。 如果未指定任何内容,则 IntelliJ IDEA 将启动在指定位置检测到的所有处理器。
注解处理器选项 :使用此区域配置处理器运行选项,无论是作为
-key=value,还是key=value。 使用空格来分隔各个选项。