Maven 第一个项目：从零到运行（10分钟上手）

---

目标

使用 Maven 创建一个 “Hello World” 项目，完成：

• 自动生成标准结构
• 编写主类
• 添加 JUnit 测试
• 编译 + 测试 + 打包
• 运行程序

---

前提条件（已完成）

• JDK 17+ 已安装
• Maven 3.9.x 已配置好环境变量
• mvn -version 命令可用

---

第一步：创建项目（推荐方式）

mvn archetype:generate \
  -DgroupId=com.example \
  -DartifactId=hello-maven \
  -DarchetypeArtifactId=maven-archetype-quickstart \
  -DinteractiveMode=false

解释：

• archetype:generate：使用模板生成项目
• maven-archetype-quickstart：最简单 Java 项目模板
• -DinteractiveMode=false：跳过交互，直接生成

---

第二步：查看项目结构

cd hello-maven
tree .   # macOS/Linux
# 或 Windows 使用 dir /s

hello-maven/
├── pom.xml
└── src/
    ├── main/
    │   └── java/
    │       └── com/
    │           └── example/
    │               └── App.java
    └── test/
        └── java/
            └── com/
                └── example/
                    └── AppTest.java

---

第三步：修改主类（打印 Hello Maven）

编辑 src/main/java/com/example/App.java：

package com.example;

public class App {
    public static void main(String[] args) {
        System.out.println("Hello Maven! 第一个项目成功运行！");
    }
}

---

第四步：运行 Maven 命令

命令	作用
mvn compile	编译主代码 → 生成 target/classes
mvn test	运行测试 → 通过 JUnit
mvn package	打包成 JAR → 生成 target/hello-maven-1.0.jar
mvn clean	删除 target 目录

推荐一键执行：

mvn clean package

输出成功：

[INFO] BUILD SUCCESS
[INFO] Total time:  3.123 s

---

第五步：运行打包好的 JAR

java -cp target/hello-maven-1.0.jar com.example.App

输出：

Hello Maven! 第一个项目成功运行！

---

第六步：查看 pom.xml（核心文件）

<project ...>
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.example</groupId>
  <artifactId>hello-maven</artifactId>
  <version>1.0</version>
  <packaging>jar</packaging>

  <properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
  </properties>

  <dependencies>
    <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter</artifactId>
      <version>5.10.3</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
</project>

---

第七步：进阶 — 打包成“胖 JAR”（可执行）

修改 pom.xml，添加 maven-shade-plugin：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-shade-plugin</artifactId>
      <version>3.6.0</version>
      <executions>
        <execution>
          <phase>package</phase>
          <goals><goal>shade</goal></goals>
          <configuration>
            <transformers>
              <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                <mainClass>com.example.App</mainClass>
              </transformer>
            </transformers>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

重新打包：

mvn clean package

现在直接运行：

java -jar target/hello-maven-1.0-shaded.jar

输出：

Hello Maven! 第一个项目成功运行！

---

完整命令总结（复制粘贴）

# 1. 创建项目
mvn archetype:generate -DgroupId=com.example -DartifactId=hello-maven -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

# 2. 进入项目
cd hello-maven

# 3. 修改 App.java（打印 Hello Maven!）

# 4. 编译 + 测试 + 打包
mvn clean package

# 5. 运行
java -cp target/hello-maven-1.0.jar com.example.App

---

常见问题

问题	解决方案
java: package com.example does not exist	检查 src/main/java/com/example/App.java 路径
Could not transfer artifact	配置阿里云镜像（settings.xml）
java.lang.UnsupportedClassVersionError	JDK 版本太低，升级到 17+

---

恭喜！你已完成 Maven 第一个项目！

---

下一步建议

方向	命令
IDEA 导入	打开 hello-maven 文件夹 → 自动识别 Maven
添加 Spring Boot	使用 spring-boot-starter-parent
多模块项目	创建 parent + module-a

---

需要 IDEA 导入教程 或 Spring Boot + Maven 示例？
回复 IDEA 或 Spring Boot 即可获取！