能否不借助插件配置Maven编译生成源码？实践遇阻求解答

我明白你的困惑——你看到ANTLR4这类插件把生成的源码放到target/generated-sources/antlr4就能自动编译，自己用exec插件生成到类似路径却不行，还以为是哪里配置错了。其实这里的关键是：不是所有放到generated-sources下的目录都会被Maven自动识别为源码目录，只有那些主动告诉Maven“这是源码目录”的插件生成的内容才会被自动处理。

为什么ANTLR4插件可以自动生效？ #

像ANTLR4 Maven插件这类专门的代码生成插件，它们在执行过程中会调用Maven的内部API，把自己的输出目录（也就是target/generated-sources/antlr4）主动添加到项目的源码路径列表里。Maven编译阶段会遍历所有已注册的源码目录，自然就会编译这些生成的代码。

你的exec插件为什么不行？ #

exec-maven-plugin是一个通用的执行插件，它的核心功能只是帮你运行外部Java程序（你的CodeGenerator），但它不会主动和Maven的源码路径管理交互。哪怕你把生成的代码放到generated-sources下的任意子目录，Maven也不知道这个目录需要被加入编译路径——它只会默认处理src/main/java、src/main/resources这些标准目录，以及其他插件主动注册的目录。

解决方案 #

你已经尝试的build-helper-maven-plugin方案是最直接有效的，也是社区推荐的做法。这里给你适配你的场景的完整配置：

<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>build-helper-maven-plugin</artifactId>
  <version>3.3.0</version>
  <executions>
    <execution>
      <id>add-generated-sources</id>
      <!-- 要在generate-sources阶段之后执行，确保生成的代码已经存在 -->
      <phase>generate-sources</phase>
      <goals>
        <goal>add-source</goal>
      </goals>
      <configuration>
        <sources>
          <!-- 指定你的生成代码目录 -->
          <source>${project.build.directory}/generated-sources/generate-code/</source>
        </sources>
      </configuration>
    </execution>
  </executions>
</plugin>

关于Maven生成源码指南的误解 #

Maven文档里说“无需辅助插件”，指的是那些本身集成了源码目录注册逻辑的专用生成插件（比如ANTLR4、JAXB2、ProtoBuf插件等）。这些插件在设计时就遵循了Maven的规范，自动完成了目录注册。但像exec这种通用插件，因为它可以执行任意程序，Maven无法预判你生成的内容是否是需要编译的源码，所以必须手动通过build-helper来注册目录。

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