IntelliJ保存文件时不自动生成Mapstruct映射器，如何解决？

1. 核对注解处理器的具体配置 #

• 打开File > Settings > Build, Execution, Deployment > Compiler > Annotation Processors
  • 勾选Enable annotation processing
  • 确认Processor path里能识别到org.mapstruct:mapstruct-processor依赖，没自动加载的话手动添加对应JAR包
  • 选中Obtain processors from project classpath，让IntelliJ从项目依赖里获取处理器
• 检查pom.xml中MapStruct的配置，确保处理器依赖范围正确，且绑定到compile阶段：

<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct</artifactId>
    <version>你的使用版本</version>
</dependency>
<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct-processor</artifactId>
    <version>你的使用版本</version>
    <scope>provided</scope>
</dependency>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.12.1</version>
            <configuration>
                <source>21</source>
                <target>21</target>
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.mapstruct</groupId>
                        <artifactId>mapstruct-processor</artifactId>
                        <version>你的使用版本</version>
                    </path>
                    <!-- 其他注解处理器如lombok也需在此配置 -->
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 调整自动构建策略 #

• 打开File > Settings > Build, Execution, Deployment > Compiler
  • 勾选Build project automatically
  • 可选勾选Compile independent modules in parallel提升构建速度
• 按Ctrl+Shift+A（Windows/Linux）或Cmd+Shift+A（Mac）搜索Registry，找到compiler.automake.allow.when.app.running并勾选，让项目运行时也能触发自动构建

3. 配置Maven自动同步 #

• 打开View > Tool Windows > Maven，点击左上角齿轮图标
  • 勾选Import Maven projects automatically
  • 在Importing标签页，给VM options for importer设置-Xmx1024m（按需调整内存），保证依赖正确导入
• 右键项目根目录，选Maven > Reload Project，同步所有依赖和配置

4. 安装MapStruct辅助插件（可选） #

• 打开File > Settings > Plugins，搜索MapStruct Support并安装，增强IntelliJ对MapStruct的支持，优化生成触发逻辑

5. 检查生成目录配置 #

• 确认target/generated-sources/annotations被标记为Sources Root：右键该目录，选Mark Directory as > Sources Root，让IntelliJ正确识别生成的代码

如果以上操作后仍无效，试试清除IntelliJ缓存：File > Invalidate Caches... > Invalidate and Restart，重启后再测试保存映射器接口的效果。

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