如何让IntelliJ IDE在修改Kotlin源码时触发注解处理

我完全懂你这种挫败感——用mvn clean compile命令行编译时，注解处理器乖乖生成META-INF资源文件，但在IntelliJ里改个带注解的Kotlin类名，处理器就像消失了一样，完全不更新资源。咱们一步步来搞定这个问题：

1. 确认IntelliJ的Kapt专属配置是否正确 #

Kotlin的注解处理器依赖kapt工具，不是普通Java的注解处理配置，别搞混了：

• 打开File → Settings → Build, Execution, Deployment → Compiler → Kotlin Compiler → Annotation Processing
• 确保Enable annotation processing已经勾选
• 选择Processors path为Module output and dependencies（对应你提到的“从项目类路径获取处理器”选项）
• 同时检查普通注解处理页面Annotation Processors，确保没有冲突的配置（比如不要手动指定处理器路径，让kapt自动处理）

2. 强制同步Maven配置到IntelliJ #

有时候IntelliJ不会自动读取pom里的kapt配置，手动刷新试试：

• 右键项目根目录 → Maven → Reload Project
• 或者点击右侧Maven面板顶部的刷新按钮，等待项目重新导入完成

3. 清理缓存+全量重建 #

IntelliJ的缓存经常会搞出各种奇怪的问题，直接清掉：

• 打开File → Invalidate Caches...
• 勾选Clear file system cache and local history，然后点击Invalidate and Restart
• 重启后手动删除项目根目录下的target文件夹，再执行Build → Rebuild Project（别用Make Project，全量重建更可靠）

4. 调整pom.xml的kapt依赖配置 #

你的pom里已经在kapt执行块指定了注解处理器，但可以尝试给kapt明确添加处理器依赖，帮助IntelliJ识别：
在kotlin-maven-plugin的kapt execution的configuration里添加处理器依赖：

<configuration>
  <sourceDirs>
    <sourceDir>src/main/kotlin</sourceDir>
  </sourceDirs>
  <annotationProcessors>
    <annotationProcessor>org.example.MyProcessor</annotationProcessor>
  </annotationProcessors>
  <!-- 添加这部分 -->
  <dependencies>
    <dependency>
      <groupId>org.example</groupId>
      <artifactId>processor</artifactId>
      <version>1</version>
      <scope>compile</scope>
    </dependency>
  </dependencies>
</configuration>

同时可以把processor模块的依赖范围改成provided，避免打包到最终产物里：

<dependency>
  <groupId>org.example</groupId>
  <artifactId>processor</artifactId>
  <version>1</version>
  <scope>provided</scope>
</dependency>

5. 检查版本兼容性 #

Kotlin 1.2.0和IntelliJ 2017.3理论上是兼容的，但要确保IntelliJ的Kotlin插件版本和你的项目Kotlin版本一致：

• 打开File → Settings → Plugins，找到Kotlin插件，查看版本是否为1.2.x
• 如果插件版本不匹配，尝试更新插件（注意2017.3的插件可能已经停止更新，实在不行可以降级Kotlin版本到插件支持的版本）

按照这些步骤试下来，应该能让IntelliJ正确触发你的注解处理器了。

内容的提问来源于stack exchange，提问作者gclaussn