IntelliJ IDEA配置@Immutables注解异常：IDE报错但Maven编译正常

这种情况我之前也碰到过，Maven能正常跑但IDE报红确实挺闹心的，本质上是IntelliJ没正确识别Immutables生成的代码或者注解处理器配置有问题，下面几个步骤逐一排查应该能解决：

1. 开启IntelliJ的注解处理器支持 #

打开IntelliJ的设置（快捷键Ctrl+Alt+S，或者通过File → Settings进入），找到Build, Execution, Deployment → Compiler → Annotation Processors：

• 确保Enable annotation processing选项处于勾选状态
• 推荐选择Obtain processors from project classpath，让IDE自动从项目依赖中获取注解处理器
• 确认Generated sources directory设置为target/generated-sources/annotations（这是Maven默认的生成源码目录），设置完成后点击Apply保存

2. 刷新Maven并重新生成源码 #

• 在IntelliJ右侧的Maven面板中，点击顶部的「Reload All Maven Projects」图标（圆圈箭头样式），让IDE重新同步依赖和配置
• 手动触发一次编译：可以在Maven面板中找到Lifecycle → compile双击执行，或者直接在终端运行mvn compile命令
• 之后右键项目根目录，选择Maven → Generate Sources and Update Folders，确保生成的源码被IDE正确识别

3. 将生成源码目录标记为Sources Root #

找到项目中的target/generated-sources/annotations目录（如果你的配置自定义了路径，就找对应的目录）：

• 右键该目录，选择Mark Directory as → Sources Root
• 这个操作会让IntelliJ把该目录下的代码当作项目源码的一部分，不再标记为错误

4. 清理IDE缓存并重启 #

有时候IDE缓存会抽风导致识别异常：

• 点击File → Invalidate Caches...
• 在弹出的窗口中勾选Invalidate and Restart，等待IDE重启后再检查生成的类是否还报红

5. 检查pom.xml中的依赖配置是否规范 #

确保Immutables的依赖和注解处理器配置正确，推荐的配置如下：

<!-- Immutables核心依赖，scope设为provided避免打包到产物中 -->
<dependency>
  <groupId>org.immutables</groupId>
  <artifactId>value</artifactId>
  <version>你的版本号</version>
  <scope>provided</scope>
</dependency>

<!-- Maven编译插件配置，明确指定注解处理器路径 -->
<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.8.1</version>
      <configuration>
        <source>1.8</source> <!-- 替换为你的项目JDK版本 -->
        <target>1.8</target>
        <annotationProcessorPaths>
          <path>
            <groupId>org.immutables</groupId>
            <artifactId>value</artifactId>
            <version>你的版本号</version>
          </path>
        </annotationProcessorPaths>
      </configuration>
    </plugin>
  </plugins>
</build>

使用annotationProcessorPaths可以确保注解处理器只在编译阶段生效，避免依赖冲突问题。

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