Maven环境配置教程与安装步骤详解

时间：2026-08-13 | 作者：穿越地图的猫 | 阅读：0

Ma ven 是一个基于 Ja va 的工具，安装前首先需要安装 JDK。

下载 JDK（推荐 JDK 8/11/17）：

Oracle JDK
OpenJDK

如果你还未安装 JDK，可以参考我们的 Ja va 开发环境配置。

安装前准备

系统要求

项目	要求
JDK	Ma ven 3.3 要求 JDK 1.7 或以上 Ma ven 3.2 要求 JDK 1.6 或以上 Ma ven 3.0/3.1 要求 JDK 1.5 或以上
内存	没有最低要求
磁盘	Ma ven 自身安装需要大约 10 MB 空间。除此之外，额外的磁盘空间将用于你的本地 Ma ven 仓库。你本地仓库的大小取决于使用情况，但预期至少 500 MB
操作系统	没有最低要求

检查 Ja va 安装

安装 Ma ven 之前，建议先确认 Ja va 是否已正确安装。

操作系统	任务	命令
Windows	打开命令控制台	`c:> ja va -version`
Linux	打开命令终端	`# ja va -version`
Mac	打开终端	`$ ja va -version`

Ma ven 下载

Ma ven 下载地址：http://ma ven.apache.org/download.cgi

不同平台请下载对应的安装包：

系统	包名
Windows	apache-ma ven-3.3.9-bin.zip
Linux	apache-ma ven-3.3.9-bin.tar.gz
Mac	apache-ma ven-3.3.9-bin.tar.gz

下载完成后，将压缩包解压到对应目录：

系统	存储位置 (可根据自己情况配置)
Windows	E:Ma venapache-ma ven-3.3.9
Linux	/usr/local/apache-ma ven-3.3.9
Mac	/usr/local/apache-ma ven-3.3.9

设置 Ma ven 环境变量

安装完成后，需要添加环境变量 MA VEN_HOME。

系统配置

Windows

系统	配置
Windows	先右键“计算机”，打开“属性”。进入“高级系统设置”，再点击“环境变量”进行配置。接下来，需要设置的系统变量主要有以下几项：新建系统变量 MA VEN_HOME，变量值：`E:Ma venapache-ma ven-3.3.9` 编辑系统变量 Path，添加变量值：`;%MA VEN_HOME%bin` 注意：多个值之间需要有分号隔开，然后点击确定。
Linux	下载解压： `# wget http://mirrors.hust.edu.cn/apache/ma ven/ma ven-3/3.3.9/binaries/apache-ma ven-3.3.9-bin.tar.gz # tar -xvf apache-ma ven-3.3.9-bin.tar.gz # sudo mv -f apache-ma ven-3.3.9 /usr/local/` 打开并编辑 /etc/profile 文件。执行 `sudo vim /etc/profile`，然后在文件末尾补上下面这段代码： `export MA VEN_HOME=/usr/local/apache-ma ven-3.3.9 export PATH=${PATH}:${MA VEN_HOME}/bin` 保存文件后，运行如下命令使环境变量生效： `# source /etc/profile` 在控制台输入如下命令。如果能看到 Ma ven 相关版本信息，则说明 Ma ven 已经安装成功： `# mvn -v`
Mac	下载解压： `$ curl -O http://mirrors.hust.edu.cn/apache/ma ven/ma ven-3/3.3.9/binaries/apache-ma ven-3.3.9-bin.tar.gz $ tar -xvf apache-ma ven-3.3.9-bin.tar.gz $ sudo mv -f apache-ma ven-3.3.9 /usr/local/` 编辑 /etc/profile 文件 `sudo vim /etc/profile`。在文件末尾添加如下代码： `export MA VEN_HOME=/usr/local/apache-ma ven-3.3.9 export PATH=${PATH}:${MA VEN_HOME}/bin` 保存文件后，运行如下命令使环境变量生效： `$ source /etc/profile` 在控制台输入如下命令。如果能看到 Ma ven 相关版本信息，则说明 Ma ven 已经安装成功： `$ mvn -v Apache Ma ven 3.3.9 (bb52d8502b132ec0a5a3f4c09453c07478323dc5; 2015-11-11T00:41:47+08:00) Ma ven home: /usr/local/apache-ma ven-3.3.9 Ja va version: 1.8.0_31, vendor: Oracle Corporation Ja va home: /Library/Ja va/Ja vaVirtualMachines/jdk1.8.0_31.jdk/Contents/Home/jre Default locale: zh_CN, platform encoding: ISO8859-1 OS name: "mac os x", version: "10.13.4", arch: "x86_64", family: "mac"`

先右键“计算机”，打开“属性”。

进入“高级系统设置”，再点击“环境变量”进行配置。

接下来，需要设置的系统变量主要有以下几项：

新建系统变量 MA VEN_HOME，变量值：E:Ma venapache-ma ven-3.3.9

编辑系统变量 Path，添加变量值：;%MA VEN_HOME%bin

注意：多个值之间需要有分号隔开，然后点击确定。

Linux

下载解压：

# wget http://mirrors.hust.edu.cn/apache/ma ven/ma ven-3/3.3.9/binaries/apache-ma ven-3.3.9-bin.tar.gz
# tar -xvf  apache-ma ven-3.3.9-bin.tar.gz
# sudo mv -f apache-ma ven-3.3.9 /usr/local/

打开并编辑 /etc/profile 文件。

执行 sudo vim /etc/profile，然后在文件末尾补上下面这段代码：

export MA VEN_HOME=/usr/local/apache-ma ven-3.3.9
export PATH=${PATH}:${MA VEN_HOME}/bin

保存文件后，运行如下命令使环境变量生效：

# source /etc/profile

在控制台输入如下命令。

如果能看到 Ma ven 相关版本信息，则说明 Ma ven 已经安装成功：

# mvn -v

Mac

下载解压：

$ curl -O http://mirrors.hust.edu.cn/apache/ma ven/ma ven-3/3.3.9/binaries/apache-ma ven-3.3.9-bin.tar.gz
$ tar -xvf  apache-ma ven-3.3.9-bin.tar.gz
$ sudo mv -f apache-ma ven-3.3.9 /usr/local/

编辑 /etc/profile 文件 sudo vim /etc/profile。

在文件末尾添加如下代码：

export MA VEN_HOME=/usr/local/apache-ma ven-3.3.9
export PATH=${PATH}:${MA VEN_HOME}/bin

保存文件后，运行如下命令使环境变量生效：

$ source /etc/profile

在控制台输入如下命令。

如果能看到 Ma ven 相关版本信息，则说明 Ma ven 已经安装成功：

$ mvn -v
Apache Ma ven 3.3.9 (bb52d8502b132ec0a5a3f4c09453c07478323dc5; 2015-11-11T00:41:47+08:00)
Ma ven home: /usr/local/apache-ma ven-3.3.9
Ja va version: 1.8.0_31, vendor: Oracle Corporation
Ja va home: /Library/Ja va/Ja vaVirtualMachines/jdk1.8.0_31.jdk/Contents/Home/jre
Default locale: zh_CN, platform encoding: ISO8859-1
OS name: "mac os x", version: "10.13.4", arch: "x86_64", family: "mac"

验证安装

完成环境变量配置后，可以执行以下命令验证安装结果：

mvn -v  # 应输出 Ma ven 版本和 Ja va 信息

配置 Ma ven 本地仓库

Ma ven 默认从远程仓库下载依赖，并存储在本地。

默认本地仓库路径

Windows: C:Users<用户名>.m2repository
Linux/macOS: ~/.m2/repository

修改仓库位置（可选）

在 MA VEN_HOME/conf/settings.xml 中修改：

/path/to/your/repo

第一个 Ma ven 项目

使用 Ma ven 创建项目

运行以下命令生成标准 Ja va 项目：

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

这会生成一个标准 Ma ven 项目结构：

my-first-app/
├── pom.xml           # 项目配置文件
├── src/
│   ├── main/         # 主代码
│   │   └── ja va/     # Ja va 源代码
│   └── test/         # 测试代码
│       └── ja va/     # 测试类

解读 pom.xml

生成的 pom.xml 示例：


    4.0.0
    com.example      
    my-first-app  
    1.0-SNAPSHOT     

        
            junit    
            junit
            4.12
            test