Maven 入门指南:核心概念与环境搭建
什么是 Maven?
Maven 是 Apache 软件基金会维护的一个项目管理和构建自动化工具,主要用于 Java 项目的依赖管理、编译、测试和打包。它通过一个标准化的项目结构和声明式的配置文件(POM)来简化开发流程。官方网站为:http://maven.apache.org/。
安装与基础配置
在开始使用 Maven 前,需确保系统中已正确安装并配置了 JDK。可访问 Maven 官方下载页面获取最新版本的二进制包。
将下载的压缩包解压至指定目录,例如:D:\maven\apache-maven-3.8.6。
设置环境变量
- M2_HOME:指向 Maven 的安装路径,如:
D:\maven\apache-maven-3.8.6 - Path:添加
%M2_HOME%\bin到系统 Path 变量中,注意使用分号与其他条目分隔。
配置完成后,在命令行执行 mvn -v 验证是否安装成功,若显示 Maven 和 Java 版本信息,则表示配置成功。
创建第一个 Maven 项目
按照 Maven 的标准目录结构,手动创建如下项目骨架:
HelloWorld/ ├── src/ │ ├── main/ │ │ └── java/ │ │ └── com/ │ │ └── example/ │ │ └── App.java │ └── test/ │ └── java/ │ └── com/ │ └── example/ │ └── AppTest.java ├── pom.xml
编写主类 App.java
package com.example;
public class App {
public String greet() {
return "Hello World!";
}
public static void main(String[] args) {
System.out.println(new App().greet());
}
}
编写测试类 AppTest.java
使用 JUnit 编写单元测试,需要先在 pom.xml 中引入依赖。
package com.example;
import org.junit.Test;
import static org.junit.Assert.assertEquals;
public class AppTest {
@Test
public void testGreet() {
App app = new App();
String result = app.greet();
assertEquals("Hello World!", result);
}
}
配置 pom.xml 文件
POM(Project Object Model)是 Maven 的核心配置文件,定义项目元数据及依赖关系。
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>HelloWorld</artifactId>
<version>1.0.0</version>
<dependencies>
<!-- JUnit 测试框架 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13.2</version>
<scope>test</scope>
</dependency>
</dependencies>
</project>
常用 Maven 命令实践
mvn compile:编译主源码,输出到target/classesmvn test-compile:编译测试代码mvn test:运行所有单元测试mvn package:打包项目为 JAR 文件(位于target/目录下)mvn clean:清除target目录mvn install:将项目安装到本地仓库,供其他项目引用
进入项目根目录后执行 mvn test,控制台将显示测试结果:
------------------------------------------------------- T E S T S ------------------------------------------------------- Running com.example.AppTest Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.012 sec Results: Tests run: 1, Failures: 0, Errors: 0, Skipped: 0 [INFO] BUILD SUCCESS
执行 mvn package 后,可在 target/HelloWorld-1.0.0.jar 找到生成的 JAR 包。
修改本地仓库路径
Maven 默认将依赖库缓存于用户目录下的 .m2/repository,通常位于 C 盘。为避免占用系统盘空间,可通过修改配置迁移路径。
编辑 conf/settings.xml 文件,在 <settings> 标签内添加:
<localRepository>E:/maven/repo</localRepository>
保存后,所有后续下载的依赖都将存储至新路径。
远程依赖查找推荐使用 https://mvnrepository.com/,搜索所需库并复制对应的 Maven 依赖片段即可集成。