如何在 Maven 中精准排除特定源码目录（非资源文件）

霞舞 2026-01-05 00:00:00 次阅读

maven 原生不支持直接通过 `` 排除源码子目录，但可通过 `maven-compiler-plugin` 的 `` 白名单机制实现精确源码路径控制，并配合跳过测试等策略解决模块化项目中的编译冲突。

在标准 Maven 生命周期中，仅支持全局指定根路径（如 src/main/java），不支持在 POM 中声明等排除子目录的语法——这是由 Maven 的源码解析模型决定的：它将整个 sourceDirectory 视为原子性编译单元，交由编译插件统一处理，而非构建阶段预过滤。

真正可行的解决方案是转向“白名单优先”策略，即通过 maven-compiler-plugin 显式声明需编译的包路径，间接实现对冲突目录（如 src/main/java/com/company/project/conflict-dir）的逻辑排除：


  
    
      org.apache.maven.plugins
      maven-compiler-plugin
      3.8.0
      
        ${maven.compiler.source}
        ${maven.compiler.target}
        UTF-8
        
        
          com/company/my_module/**/*.java

✅ 关键说明：是白名单机制，未匹配的 .java 文件（包括冲突目录下所有类）将被完全忽略，不参与编译；路径格式为 Java 包路径风格（用 / 分隔，非文件系统路径），且必须相对于 sourceDirectory 根目录；若需排除多个无关包，可添加多个，或使用更宽泛的模式（如 com/company/**/service/**/*.java）。

此外，在多模块项目中，还需警惕隐式行为带来的干扰：

Maven 默认会执行 test 阶段，若当前模块未提供对应测试类，但父 POM 或继承链中启用了测试扫描，可能导致 ClassNotFoundException 或编译失败；
此时应显式跳过测试：构建时添加 -Dmaven.test.skip=true（跳过编译与执行），或在 POM 中配置：
```
  org.apache.maven.plugins
  maven-surefire-plugin
  
    true
  
```

⚠️ 注意事项：