TopGuides！

如何在 Windows 上安装 Apache Maven 3.9.6

简介

本教程将指导您如何在 windows 系统上安装 Apache Maven 3.9.6。Apache Maven是一个软件项目管理和构建自动化工具，主要用于Java项目。Maven使用项目对象模型(POM)的概念，通过一个中央信息管理项目的构建、报告和文档。

前置要求

  • Windows 操作系统
  • 稳定的网络连接
  • 管理员权限
  • 已安装Java开发工具包(JDK)，Maven 3.3+需要JDK 1.7或更高版本
  • 至少10MB的可用磁盘空间用于Maven安装
  • 额外的磁盘空间用于本地Maven仓库

安装方法

使用官方二进制包

从Apache Maven官方网站下载并安装Maven。

1. 下载Maven

访问Apache Maven官方网站下载最新的二进制包。

https://maven.apache.org/download.cgi

选择apache-maven-3.9.6-bin.zip文件下载。

2. 解压文件

将下载的zip文件解压到您选择的目录，例如C:\Program Files\Apache\Maven。

3. 设置环境变量

设置MAVEN_HOME环境变量并将Maven的bin目录添加到PATH环境变量中。

# 设置MAVEN_HOME环境变量
set MAVEN_HOME=C:\Program Files\Apache\Maven\apache-maven-3.8.6

# 将Maven的bin目录添加到PATH环境变量
set PATH=%PATH%;%MAVEN_HOME%\bin

您可以通过系统属性对话框（右键点击"此电脑" -> 属性 -> 高级系统设置 -> 环境变量）永久设置这些环境变量。

使用Chocolatey包管理器

Chocolatey是Windows的包管理器，可以简化Maven的安装过程。

1. 安装Chocolatey

如果您尚未安装Chocolatey，请先安装它。

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

在管理员权限的PowerShell中运行此命令。

2. 使用Chocolatey安装Maven

使用Chocolatey安装Maven。

choco install maven

在管理员权限的命令提示符或PowerShell中运行此命令。

验证安装

1. 验证Maven安装

验证Maven是否正确安装及其版本：

mvn -v
Apache Maven 3.8.6 (84538c9988a25aec085021c365c560670ad80f63)
Maven home: /usr/local/apache-maven-3.8.6
Java version: 11.0.12, vendor: Oracle Corporation, runtime: /Library/Java/JavaVirtualMachines/jdk-11.0.12.jdk/Contents/Home
Default locale: en_US, platform encoding: UTF-8
OS name: "mac os x", version: "12.0", arch: "x86_64", family: "mac"

2. 创建测试项目

创建一个简单的Maven项目来测试安装：

mvn archetype:generate -DgroupId=com.example -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

这个命令将创建一个基本的Maven项目结构。如果成功，说明Maven安装正确。

3. 构建测试项目

进入测试项目目录并构建项目：

cd my-app
mvn package

如果构建成功，您将在target目录中看到生成的JAR文件。

4. 运行测试项目

运行生成的JAR文件：

java -cp target/my-app-1.0-SNAPSHOT.jar com.example.App
Hello World!

如果看到"Hello World!"输出，说明Maven项目构建和运行成功。

基本使用示例

创建新项目

使用Maven原型创建一个新的Java项目：

mvn archetype:generate -DgroupId=com.example -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

这个命令使用Maven的原型插件创建一个基本的Java项目结构。groupId是项目的组织标识符，artifactId是项目名称。

构建项目

编译项目代码并打包：

cd my-app
mvn package

package命令会执行编译、测试和打包阶段，生成一个JAR文件。

运行测试

运行项目中的单元测试：

mvn test

这个命令会编译并运行项目中的所有测试类。

清理项目

清理项目构建目录：

mvn clean

这个命令会删除target目录及其所有内容，包括编译的类文件和生成的JAR文件。

安装到本地仓库

将项目构建并安装到本地Maven仓库：

mvn install

这个命令会构建项目并将其安装到本地Maven仓库，使其可以被其他本地项目依赖。

查看依赖树

查看项目的依赖关系树：

mvn dependency:tree

这个命令显示项目的所有依赖项及其传递依赖，以树形结构展示。

创建站点文档

生成项目文档站点：

mvn site

这个命令会生成一个包含项目信息、JavaDoc、测试报告等内容的HTML站点。

常见问题

问题：maven command not found

解决方案：确保软件已正确安装并添加到系统PATH中。可能需要重启终端或系统。

问题：安装过程中遇到权限错误

解决方案：确保您有管理员权限。在Windows上以管理员身份运行命令提示符，在Mac/Linux上使用sudo。

问题：Maven无法连接到远程仓库

解决方案：检查您的网络连接和代理设置。您可以在Maven的settings.xml文件中配置代理设置。

<proxies>
  <proxy>
    <id>example-proxy</id>
    <active>true</active>
    <protocol>http</protocol>
    <host>proxy.example.com</host>
    <port>8080</port>
    <username>proxyuser</username>
    <password>proxypass</password>
    <nonProxyHosts>localhost|127.0.0.1</nonProxyHosts>
  </proxy>
</proxies>

问题：依赖项下载失败

解决方案：尝试清理本地仓库缓存，然后重新构建项目。

mvn clean
mvn dependency:purge-local-repository
mvn compile

问题：JAVA_HOME环境变量未设置

解决方案：确保正确设置JAVA_HOME环境变量指向您的JDK安装目录。

# Windows (CMD)
set JAVA_HOME=C:\Program Files\Java\jdk1.8.0_xxx

# Windows (PowerShell)
$env:JAVA_HOME = "C:\Program Files\Java\jdk1.8.0_xxx"

# macOS/Linux
export JAVA_HOME=/usr/lib/jvm/java-8-openjdk

使用技巧

使用Maven Wrapper（mvnw）可以确保团队成员使用相同版本的Maven，而无需全局安装Maven。

在pom.xml中使用属性（<properties>）来集中管理依赖版本，便于升级和维护。

使用Maven的profile功能为不同环境（开发、测试、生产）配置不同的构建参数。

定期运行"mvn versions:display-dependency-updates"检查依赖更新，保持项目依赖的最新状态。

使用"mvn help:effective-pom"命令查看合并了父POM和默认配置后的有效POM。

配置Maven的settings.xml文件可以设置代理、镜像和认证信息，加速依赖下载。

使用"mvn dependency:analyze"命令检测未使用的依赖和未声明的依赖。

利用Maven的多模块项目结构组织大型项目，提高代码复用和维护性。

使用Maven插件扩展构建功能，如代码质量检查、Docker镜像构建等。

配置Maven的资源过滤功能，可以在构建时替换配置文件中的变量。

相关资源

Apache Maven官方网站

Maven的官方网站，提供下载、文档和最新信息。

Maven中央仓库

搜索和浏览Maven中央仓库中的依赖项。

Maven入门指南

官方的Maven入门指南，介绍基本概念和用法。

Maven POM参考

Project Object Model (POM)的详细参考文档。

Maven插件列表

官方Maven插件的完整列表及其文档。

Maven生命周期参考

Maven构建生命周期的详细说明。

Maven中文文档

中文版的Maven教程和参考资料。

Maven实战（书籍）

一本全面介绍Maven的中文书籍，适合初学者和有经验的开发者。

总结

恭喜！您已成功安装并配置了Apache Maven 3.9.6。现在您可以使用Maven来管理Java项目的依赖项和构建过程。Maven的强大功能将帮助您简化项目管理，提高开发效率。随着您对Maven的深入了解，您将能够充分利用其插件系统和高级功能来满足各种项目需求。