构建与依赖 / 系统课时

使用 Archetype 创建第一个项目

使用 Archetype 创建第一个项目

这一课用官方 maven-archetype-quickstart 模板生成一个最小 Java 项目,并把生成结果拆成目录、POM 坐标和示例代码三部分。完成后,你应该能判断一个 Maven 项目从哪里编译、从哪里找测试,以及项目坐标由哪些字段决定。

学习目标

  • 使用固定版本的 Archetype 非交互式生成 Java 项目
  • 识别 pom.xml、src/main/java 与 src/test/java 的职责
  • 根据 groupId、artifactId 和 version 判断项目坐标

准备参数并生成项目

下面以 JDK 17 为目标,创建 com.example:hello-maven:1.0-SNAPSHOT。maven-archetype-quickstart 1.5 默认面向 Java 17;如果你的 JDK 低于 17,应先升级 JDK,或把 javaCompilerVersion 改成实际可用的版本。

bash
mvn archetype:generate "-DgroupId=com.example" "-DartifactId=hello-maven" "-DarchetypeGroupId=org.apache.maven.archetypes" "-DarchetypeArtifactId=maven-archetype-quickstart" "-DarchetypeVersion=1.5" "-DjavaCompilerVersion=17" "-DinteractiveMode=false"

预期输出只检查成功标志即可;首次执行还会下载插件与依赖,下载日志、耗时和本地仓库路径会因环境不同。

text
[INFO] BUILD SUCCESS

执行结束后,当前目录下应出现 hello-maven 文件夹。interactiveMode=false 表示参数齐全时不再逐项询问;固定 archetypeVersion=1.5 可以避免模板升级后生成内容发生变化。

读懂生成目录和 POM

进入 hello-maven 后,先按下面三处检查,不需要背完整目录结构。

路径 作用 本例应看到的内容
pom.xml Maven 项目模型与构建配置 项目坐标、Java 版本、测试依赖
src/main/java/com/example/App.java 主程序源码 App 类和 main 方法
src/test/java/com/example/AppTest.java 测试源码 针对示例代码的 JUnit 测试

pom.xml 中最先要会读的是坐标和编译版本。下面是片段示例,实际文件还会包含测试依赖与插件管理配置。

xml
<groupId>com.example</groupId>
<artifactId>hello-maven</artifactId>
<version>1.0-SNAPSHOT</version>

<properties>
  <maven.compiler.release>17</maven.compiler.release>
</properties>

验证时对照生成命令:groupId 应为 com.example,artifactId 应为 hello-maven,而 version 由 Quickstart 模板默认生成 1.0-SNAPSHOT。这三个值共同决定当前项目的 Maven 坐标。

检查示例代码是否落在正确位置

没有显式传入 package 时,Quickstart 会以 groupId 作为默认包名,因此本例源码位于 com/example 目录。打开 App.java,应看到包声明为 com.example,并由 main 方法输出 Hello World!;AppTest.java 则位于相同包路径下,用于后续 mvn test。

这里最常见的错误是手动移动 Java 文件却不修改 package 声明。例如把 App.java 移到 src/main/java/demo,但仍保留 package com.example;,目录与包名就失去一致性。初学阶段建议同时改目录和包声明,避免后续定位类时混乱。

生成失败时先查这三处

如果命令停在依赖下载阶段,先确认能访问 Maven Central;如果出现 release version 17 not supported,说明运行 Maven 的 JDK 版本低于 17;如果当前目录已经有同名 hello-maven,则先换一个 artifactId 或清理旧目录再生成。

还有一种常见情况是 mvn 命令本身找不到。此时问题不在 Archetype,而在 Maven 环境变量或安装路径。先确认安装检查已经通过,能够看到 Maven 与 Java 版本信息,再重新执行生成命令,这比反复修改 Archetype 参数更有效。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Archetype 创建第一个项目

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

登录哪都通