独一无二的 Maven 安装与配置指南

—— 适合初学者的完美起点，正版原创

1. Maven 是什么 & 为什么要用它？

Apache Maven 是 Apache 软件基金会推出的构建和依赖管理工具，广泛用于 Java 项目，也支持 C#, Ruby 等其它语言 ([维基百科][1])。
它帮你下载依赖、管理插件、构建项目，解放重复工作，专注代码！

2. 安装前准备 ✅

1. 安装 JDK（建议 JDK 8/11/17）并配置环境变量 JAVA_HOME，可参考菜鸟教程 。

3. 下载与解压 Maven

1. 打开 Maven 官网下载最新版 zip 或 tar 包（如 apache-maven-3.9.11）。
   下载地址：https://maven.apache.org/download.cgi

• 解压后的 apache-maven-3.x.x 文件夹：alt="Maven 解压后的安装目录"
• Maven bin 目录截图：alt="Maven bin 文件夹中的 mvn.cmd 文件"

4. 配置环境变量

以 Windows 为例：

• 新建系统变量：

  • MAVEN_HOME = C:\path\to\apache-maven-3.x.x

• 编辑 Path 变量，新增 %MAVEN_HOME%\bin

• 添加 MAVEN_HOME 环境变量：alt="新建 MAVEN_HOME 系统变量"
• 在 Path 添加 %MAVEN_HOME%\bin：alt="在 Path 中新增 Maven bin 路径"

5. 验证安装

打开命令提示符，新窗口输入：

mvn -version

你会看到类似：

Apache Maven 3.9.11...
Java version: 17...

如果能看到 Maven 和 Java 版本信息即配置成功。

• mvn -version 输出截图：alt="命令行显示 mvn -version 信息"

6. 可选：配置本地仓库 & 镜像加速

为了速度，可以指定本地仓库目录或添加国内镜像：

• 编辑 conf/settings.xml，配置：

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

这样可缓存依赖、提高构建效率 ([博客园][3])。

📷

• settings.xml 中配置镜像的截图：alt="settings.xml 添加阿里云镜像配置"

7. 在 IDE 中使用 Maven

• IntelliJ IDEA 默认集成 Maven，可选择内置或自定义安装路径。
• VS Code 可安装 Java & Maven 插件，并配置 maven.executable.path 指向你的 mvn.cmd。

• IDEA 设置 Maven path：alt="IDEA 中配置 Maven 安装路径"
• VS Code settings.json 中配置 Maven：alt="VS Code 设置 mvn 路径配置"

8. 常见问题 & 排查技巧

9. 快速上手 Maven 项目

在任意空目录运行：

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

完成后，在 target/ 会生成 jar 包，即可运行！

✅ 小结

• 安装 JDK 并配置 JAVA_HOME
• 下载并解压 Maven
• 配置 MAVEN_HOME 和 Path
• 验证 mvn -version
• （可选）设置本地仓库 & 镜像
• IDE 中引入 Maven

恭喜你，成为 Maven 安装配置达人！
快来试试第一个 Maven 项目，开启你的 Java 高效开发之旅吧！