Maven 下载安装与配置教程

1. Maven 简介

Maven 是一个项目管理和构建自动化工具，主要用于 Java 项目。Maven 可以帮助开发者管理项目的构建、报告和文档，简化项目依赖管理。

2. 下载 Maven

访问 Maven 官方网站 [https://maven.apache.org/download.cgi\](https://maven.apache.org/download.cgi)
下载最新版本的 Maven 二进制压缩包（Binary zip archive）

Windows 用户选择 `.zip` 格式
Linux/Mac 用户选择 `.tar.gz` 格式

3. 安装 Maven

Windows 系统安装步骤

将下载的 zip 文件解压到您选择的目录，例如 `C:\Program Files\Apache\maven`
设置环境变量：

右键点击"此电脑"，选择"属性"
点击"高级系统设置"
点击"环境变量"按钮
在"系统变量"部分，点击"新建"
变量名设置为 `MAVEN_HOME`，变量值设置为 Maven 的安装目录（例如 `C:\Program Files\Apache\maven`）
找到"系统变量"中的 `Path` 变量，点击"编辑"
点击"新建"，添加 `%MAVEN_HOME%\bin`
点击"确定"保存所有更改

Linux 系统安装步骤

```bash

tar -xzvf apache-maven-x.x.x-bin.tar.gz -C /opt/

```

配置环境变量，编辑 `~/.bashrc` 或 `~/.zshrc` 文件：

```bash

nano ~/.bashrc

```

添加以下内容：

```bash

export MAVEN_HOME=/opt/apache-maven-x.x.x

export PATH= $PATH:$ MAVEN_HOME/bin

```

使环境变量生效：

```bash

source ~/.bashrc

```

macOS 系统安装步骤

```bash

tar -xzvf apache-maven-x.x.x-bin.tar.gz -C /opt/

```

配置环境变量，编辑 `~/.bash_profile` 或 `~/.zshrc` 文件：

```bash

nano ~/.bash_profile

```

添加以下内容：

```bash

export MAVEN_HOME=/opt/apache-maven-x.x.x

export PATH= $PATH:$ MAVEN_HOME/bin

```

使环境变量生效：

```bash

source ~/.bash_profile

```

4. 验证安装

要验证 Maven 是否安装成功，请在命令行中运行：

```bash

mvn -version

```

如果安装成功，将显示 Maven 版本、Java 版本和系统信息。

5. Maven 配置

配置本地仓库

Maven 默认的本地仓库位于 `~/.m2/repository`。如果需要自定义本地仓库位置，可以编辑 Maven 的 `settings.xml` 文件：

在 Maven 安装目录下的 `conf` 文件夹中找到 `settings.xml` 文件
复制 `settings.xml` 到 `~/.m2/` 目录下（如果不存在，请创建）
编辑 `~/.m2/settings.xml` 文件，修改本地仓库路径：

```xml

<localRepository>D:\maven-repo</localRepository>

</settings>

```

配置镜像仓库

为了加快依赖包的下载速度，可以配置国内的 Maven 镜像仓库。编辑 `settings.xml` 文件，在 `<mirrors>` 标签中添加：

```xml

<id>aliyun</id>

<name>Aliyun Maven Repository</name>

<url>https://maven.aliyun.com/repository/public\</url>

<mirrorOf>central</mirrorOf>

</mirror>

</mirrors>

```

配置 JDK 版本

可以在 `settings.xml` 文件中配置默认的 JDK 版本：

```xml

</activation>

<maven.compiler.source>1.8</maven.compiler.source>

<maven.compiler.target>1.8</maven.compiler.target>

<maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>

</properties>

</profile>

</profiles>

```

6. Maven 基本使用

创建 Maven 项目

```bash

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

```

构建项目

```bash

mvn clean package

```

运行测试

```bash

mvn test

```

安装到本地仓库

```bash

mvn install

```

7. 常见问题解决

下载依赖超时

如果下载依赖包时出现超时问题，可以尝试：

配置国内镜像仓库
增加超时时间，在 `settings.xml` 的 `<mirrors>` 标签后添加：

```xml

<id>central</id>

<all>

</all>

</httpConfiguration>

</configuration>

</server>

</servers>

</settings>

```

找不到 JAVA_HOME

如果遇到 "No JAVA_HOME detected" 错误，请确保已经正确设置 JAVA_HOME 环境变量。