Maven 下载与安装完整指南（Windows/Mac/Linux）

原创于 2026-07-06 14:42:18 发布 · 142 阅读

1 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

话题

#IT疑难杂症诊疗室

1. 什么是 Maven？

Apache Maven 是一个强大的项目管理和构建自动化工具，主要用于 Java 项目。它基于项目对象模型 (POM)的概念，可以管理项目的构建、报告和文档。Maven 简化了构建过程，通过声明式配置管理依赖关系，让开发者能够专注于代码开发。

2. 下载 Maven

2.1 访问官方网站

首先，访问 Apache Maven 的官方网站：

官网地址：https://maven.apache.org/

2.2 选择下载版本

在官网首页找到 “Download” 链接并点击
进入下载页面后，你会看到最新的稳定版本（如 Maven 3.9.x）
选择适合你操作系统的二进制压缩包：
- Windows 用户：下载 apache-maven-3.x.x-bin.zip
- macOS/Linux 用户：下载 apache-maven-3.x.x-bin.tar.gz

2.3 镜像站点加速

如果官网下载速度较慢，可以使用国内镜像站点：

阿里云镜像：https://mirrors.aliyun.com/apache/maven/maven-3/
华为云镜像：https://mirrors.huaweicloud.com/apache/maven/

3. 安装 Maven

3.1 Windows 系统安装步骤

步骤 1：解压文件

将下载的 apache-maven-3.x.x-bin.zip 文件解压到你喜欢的目录，例如：

C:\Program Files\apache-maven-3.x.x

步骤 2：配置环境变量

右键点击“此电脑” → “属性” → “高级系统设置” → “环境变量”
在“系统变量”中新建变量：
- 变量名：MAVEN_HOME
- 变量值：C:\Program Files\apache-maven-3.x.x（你的实际解压路径）
编辑 Path 变量，在末尾添加：
```
%MAVEN_HOME%\bin
```

步骤 3：验证安装

打开命令提示符（CMD）或 PowerShell，输入：

mvn -v

如果显示 Maven 版本信息，说明安装成功。

3.2 macOS/Linux 系统安装步骤

步骤 1：解压文件

打开终端，进入下载目录，执行解压命令：

# 对于 .tar.gz 文件
tar -xzf apache-maven-3.x.x-bin.tar.gz

# 移动解压后的文件夹到合适位置
sudo mv apache-maven-3.x.x /usr/local/

步骤 2：配置环境变量

编辑 shell 配置文件（根据你的 shell 选择）：

# 对于 bash
nano ~/.bashrc

# 对于 zsh
nano ~/.zshrc

在文件末尾添加：

export MAVEN_HOME=/usr/local/apache-maven-3.x.x
export PATH=$MAVEN_HOME/bin:$PATH

使配置生效：

source ~/.bashrc   # 或 source ~/.zshrc

步骤 3：验证安装

在终端中输入：

mvn -v

应该显示 Maven 版本信息。

4. 配置 Maven 镜像加速

4.1 修改 Maven 配置文件

找到 Maven 安装目录下的 conf/settings.xml 文件，在 <mirrors> 标签内添加阿里云镜像：

<mirror>
  <id>aliyunmaven</id>
  <mirrorOf>*</mirrorOf>
  <name>阿里云公共仓库</name>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

4.2 配置本地仓库位置（可选）

如果你希望将 Maven 本地仓库放在其他位置，可以在 settings.xml 中修改：

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

5. 创建第一个 Maven 项目

5.1 使用命令行创建项目

打开终端或命令提示符，执行：

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

5.2 项目结构说明

创建成功后，你会看到以下目录结构：

my-first-app/
├── pom.xml          # 项目对象模型文件
├── src/
│   ├── main/
│   │   └── java/    # 主代码目录
│   └── test/
│       └── java/    # 测试代码目录

5.3 使用 IDE 图形界面创建项目（可选）

除了命令行方式，你也可以使用 IDE 的图形界面创建 Maven 项目，这对于初学者更加直观。

IntelliJ IDEA 创建 Maven 项目步骤：

打开 IntelliJ IDEA，点击 “New Project”
在左侧选择 “Maven”
确保已选中 “Create from archetype”，然后选择 “maven-archetype-quickstart”
填写 GroupId（如 com.example）和 ArtifactId（如 my-first-app）
选择项目存储位置，点击 “Finish”

[图：IntelliJ IDEA 新建项目界面，左侧选择 Maven，中间显示 archetype 选择，右侧填写 GroupId 和 ArtifactId]

Eclipse 创建 Maven 项目步骤：

打开 Eclipse，点击 “File” → “New” → “Other…”
在弹出的对话框中展开 “Maven” 文件夹，选择 “Maven Project”
点击 “Next”，在 “Select an Archetype” 页面勾选 “Create a simple project”
点击 “Next”，填写 GroupId、ArtifactId 和 Version
点击 “Finish”

[图：Eclipse 新建 Maven 项目对话框，显示 Maven Project 选项和 Archetype 选择页面]

注意：使用 IDE 创建项目时，IDE 会自动生成标准的 Maven 项目结构，与命令行创建的结果一致。

5.4 编译和运行项目

# 进入项目目录
cd my-first-app

# 编译项目
mvn compile

# 运行测试
mvn test

# 打包项目
mvn package

6. 常见问题与解决方案

问题 1：`mvn -v` 命令不识别

解决方案：

检查环境变量配置是否正确
确保 MAVEN_HOME 路径没有错误
重启终端或命令提示符

问题 2：下载依赖超时

解决方案：

检查网络连接
配置镜像加速（参考第 4 节）
使用 VPN 访问国外仓库

问题 3：Java 版本不兼容

解决方案：

Maven 3.3+ 需要 Java 7 或更高版本
使用 java -version 检查 Java 版本
安装合适的 JDK 版本

7. 进阶配置与优化

7.1 配置 IDE 集成

IntelliJ IDEA：File → Settings → Build, Execution, Deployment → Build Tools → Maven
Eclipse：Window → Preferences → Maven
VS Code：安装 “Maven for Java” 扩展