构建与依赖 / 系统课时

主资源与测试资源目录

主资源与测试资源目录

Maven 默认把正式运行需要的资源放在 src/main/resources,把只供测试使用的资源放在 src/test/resources。理解两类目录的复制时机和目标位置后,就能判断配置文件为什么能被应用或测试读取,并快速定位资源没有进入 classpath 的问题。

学习目标

  • 说清 src/main/resources 与 src/test/resources 的职责和默认输出目录。
  • 用 Maven 生命周期命令验证资源是否被复制,并检查复制后的相对路径。
  • 知道何时需要自定义 <resources> 或 <testResources>,以及修改后的验证方法。

默认目录与输出位置

标准 Maven 项目不写资源配置时,会使用两套约定:src/main/resources 中的文件在 process-resources 阶段复制到 target/classes,src/test/resources 中的文件在 process-test-resources 阶段复制到 target/test-classes。目录内部的相对路径保持不变,例如 src/main/resources/config/app.properties 会变成 target/classes/config/app.properties。

源目录 默认生命周期阶段 默认输出目录 典型内容
src/main/resources process-resources target/classes 应用配置、模板、静态字典
src/test/resources process-test-resources target/test-classes 测试数据、测试专用配置、样例文件

默认资源复制不会把 src/test/resources 混入正式程序使用的 target/classes。因此,生产代码若只能依赖 src/test/resources 中的文件,通常说明资源位置或代码职责划分有误。

用生命周期命令验证复制

下面的命令应在一个已有 pom.xml 的 Maven 项目根目录执行。它创建两份资源,然后让 Maven 依次处理主资源和测试资源,最后直接读取目标目录中的文件。

bash
test -f pom.xml || { echo 'missing pom.xml'; exit 1; }
mkdir -p src/main/resources/config src/test/resources/fixtures
echo 'app.name=demo' > src/main/resources/config/app.properties
echo 'fixture=local' > src/test/resources/fixtures/data.properties
mvn -q process-resources
mvn -q process-test-resources
cat target/classes/config/app.properties
cat target/test-classes/fixtures/data.properties

预期输出:

text
app.name=demo
fixture=local

如果第一条 cat 失败,先检查文件是否真的位于 src/main/resources;如果第二条失败,则确认执行的是 process-test-resources,而不是只执行了 process-resources。执行 mvn test 时也会经过这些资源处理阶段,因此测试开始前两套资源通常已经准备好。

自定义目录时要显式声明

项目如果必须沿用旧目录,例如正式资源放在 config/main、测试资源放在 config/test,可以在 pom.xml 中覆盖默认约定。以下是片段示例,依赖上下文为现有 Maven 项目的 <build> 节点。

xml
<build>
  <resources>
    <resource>
      <directory>config/main</directory>
    </resource>
  </resources>
  <testResources>
    <testResource>
      <directory>config/test</directory>
    </testResource>
  </testResources>
</build>

生效后,config/main 会复制到 target/classes,config/test 会复制到 target/test-classes。可放入两个标记文件进行完整验证:

bash
mkdir -p config/main config/test
echo 'main.marker=ok' > config/main/main.properties
echo 'test.marker=ok' > config/test/test.properties
mvn -q clean process-test-resources
cat target/classes/main.properties
cat target/test-classes/test.properties

预期输出:

text
main.marker=ok
test.marker=ok

显式配置资源集合后,不要假定 Maven 仍会替你追加原来的默认目录。若项目既要保留 src/main/resources,又要增加第二个正式资源目录,应在 <resources> 中把需要参与构建的资源项全部明确列出,并通过 target/classes 中的实际文件验收。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

主资源与测试资源目录

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通