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）。
此外，在多模块项目中，还需警惕隐式行为带来的干扰：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 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> 精确声明有效源码边界，辅以测试阶段管控，即可优雅解决共享仓库中单模块的源码冲突问题。
