maven 原生不支持直接通过 `
在标准 Maven 生命周期中，<sourceDirectory> 仅支持全局指定根路径（如 src/main/java），不支持在 POM 中声明 <excludeSourceDir> 等排除子目录的语法——这是由 Maven 的源码解析模型决定的：它将整个 sourceDirectory 视为原子性编译单元，交由编译插件统一处理，而非构建阶段预过滤。
真正可行的解决方案是转向“白名单优先”策略，即通过 maven-compiler-plugin 显式声明需编译的包路径，间接实现对冲突目录（如 src/main/java/com/company/project/conflict-dir）的逻辑排除：
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.0</version>
<configuration>
<source>${maven.compiler.source}</source>
<target>${maven.compiler.target}</target>
<encoding>UTF-8</encoding>
<!-- 仅编译指定包路径下的 Java 文件 -->
<includes>
<include>com/company/my_module/**/*.java</include>
<!-- 支持通配符：** 表示任意层级子包 -->
</includes>
</configuration>
</plugin>
</plugins>
</build>✅ 关键说明： <includes> 是白名单机制，未匹配的 .java 文件（包括冲突目录下所有类）将被完全忽略，不参与编译； 路径格式为 Java 包路径风格（用 / 分隔，非文件系统路径），且必须相对于 sourceDirectory 根目录； 若需排除多个无关包，可添加多个 <include>，或使用更宽泛的模式（如 com/company/**/service/**/*.java）。
此外，在多模块项目中，还需警惕隐式行为带来的干扰：
- Maven 默认会执行 test 阶段，若当前模块未提供对应测试类，但父 POM 或继承链中启用了测试扫描，可能导致 ClassNotFoundException 或编译失败；
- 此时应显式跳过测试：构建时添加 -Dmaven.test.skip=true（跳过编译与执行），或在 POM 中配置：
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId> <configuration> <skipTests>true</skipTests> </configuration> </plugin>
⚠️ 注意事项：
- <includes> 与 <excludes> 在 maven-compiler-plugin 中不可共存（后者在较新版本中已被弃用或行为不稳定），务必只用 <includes> 实现精准控制；
- 修改后请执行 mvn clean compile 验证，避免因旧 class 文件残留导致误判；
- 若项目依赖 IDE（如 IntelliJ），需同步刷新 Maven 项目，确保 IDE 使用更新后的编译配置。
综上，Maven 源码排除的本质不是“删除路径”，而是“限定范围”。通过 maven-compiler-plugin 的 <includes> 精确声明有效源码边界，辅以测试阶段管控，即可优雅解决共享仓库中单模块的源码冲突问题。
