史上最全 Maven 教程，没有之一

Maven 是 Java 领域内非常流行的构建工具，它简化了项目的构建过程，并且提供了强大的依赖管理和项目信息管理功能。下面是一份详细的 Maven 教程，涵盖了从安装到进阶使用的各个方面。

1. 安装 Maven

下载与安装

1. 访问 Maven 的官方下载页面：http://maven.apache.org/download.cgi
2. 下载最新版本的 Apache Maven 发行版（通常推荐使用最新稳定版）。
3. 解压缩下载的文件到指定目录（例如 /opt/maven）。
4. 设置环境变量 MAVEN_HOME 指向 Maven 的安装目录。
5. 将 Maven 的 bin 目录添加到系统的 PATH 环境变量中。

验证安装

1. 打开终端或命令提示符。
2. 运行 mvn -version 命令来检查 Maven 是否正确安装，并显示 Maven 的版本信息。

2. 配置 Maven

修改配置文件

Maven 的主配置文件位于 ${MAVEN_HOME}/conf/settings.xml。你可以修改这个文件来调整 Maven 的行为，例如设置仓库位置、镜像服务器等。

用户级配置

用户级配置文件位于用户主目录下的 .m2/settings.xml 文件。你可以在这里覆盖默认的设置，例如设置代理服务器。

3. 创建 Maven 项目

使用命令行创建项目

1. 进入你想创建项目的目录。
2. 运行 mvn archetype:generate 命令。
3. 根据提示输入项目的基本信息，如 groupId、artifactId、version 等。

使用 IDE 创建项目

大多数现代 Java IDE 支持通过图形界面创建 Maven 项目。

4. Maven 生命周期

Maven 的生命周期是一系列可执行的目标，它们按照特定的顺序执行。主要的生命周期包括：

• Clean Lifecycle: 清除项目的构建产物。
• Default Lifecycle: 构建项目的核心逻辑。
• Site Lifecycle: 生成项目文档网站。

常见的目标有：clean, compile, test, package, install, deploy。

5. Maven 插件

Maven 插件提供了扩展 Maven 功能的方式。例如：

• maven-compiler-plugin: 编译源代码。
• maven-jar-plugin: 创建 JAR 文件。
• maven-surefire-plugin: 运行单元测试。
• maven-deploy-plugin: 部署构建产物到远程仓库。

6. Maven 依赖管理

添加依赖

在 pom.xml 文件中添加依赖项。例如，添加 JUnit 依赖：

<dependencies>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
        <scope>test</scope>
    </dependency>
</dependencies>
1
2
3
4
5
6
7
8

依赖范围

• compile: 编译阶段需要的依赖。
• test: 测试阶段需要的依赖，不会传递给依赖此项目的项目。
• provided: 类似于 compile，但在运行时不需要，如 Servlet 容器提供的类。
• runtime: 在运行和测试阶段需要的依赖。
• system: 与 provided 类似，但需要显式提供一个本地文件路径。
• import: 用于导入另一个 BOM (Bill of Materials) 的依赖管理。

7. 多模块项目

Maven 支持多模块项目结构，这允许将大型项目拆分为多个子模块，每个子模块都有自己的 pom.xml。

8. Maven Repository

本地 Repository

Maven 默认会将所有依赖下载到本地 .m2/repository 目录。

远程 Repository

Maven 会从中央仓库下载依赖，也可以配置私有仓库。

9. 高级特性

Profile

Profile 允许为不同的环境定义不同的配置，如开发、测试和生产环境。

Build Helper

Maven 提供了一些辅助插件，如 maven-helper-plugin，可以帮助管理构建过程。

Site 和 Reporting

Maven 可以生成项目的文档站点，包括 Javadoc、项目报告等。

集成 CI/CD

Maven 可以轻松地集成到持续集成/持续部署 (CI/CD) 系统中，如 Jenkins。

10. 最佳实践

• 使用版本控制管理 pom.xml。
• 使用标准的 Maven 目录结构。
• 使用统一的编码格式。
• 维护清晰的依赖树。
• 定期清理项目。

以上就是 Maven 的基本教程。随着对 Maven 更深入的理解，你还可以探索更多高级特性和最佳实践。如果你有任何具体的问题或遇到困难，随时欢迎提问！