Maven 保姆级教程（下载+安装+配置+验证，新手零踩坑）

哈哈哈笑什么
6 阅读7分钟

Maven 保姆级教程（下载+安装+配置+验证，新手零踩坑）

核心说明：Maven 是 Java 项目的构建工具，主要用于项目依赖管理、编译打包，新手学习需先确保 JDK 已安装并配置完成（建议 JDK8 及以上，对应 Maven 3.6+ 版本，适配性最佳），全程无复杂操作，跟着步骤走即可成功。

一、前置准备（必看）

  1. 确认 JDK 已安装：打开 CMD，输入 java -version 和 javac，均能正常输出（无报错），说明 JDK 配置生效；

  2. 注意事项：所有路径（Maven 下载解压路径、后续本地仓库路径）禁止包含中文、空格、特殊字符（比如不要放在“桌面\我的工具”“D:\Program Files”下），否则会出现配置失败、命令报错等问题。

二、Maven 下载（步骤清晰，直接照搬）

步骤1：进入官方下载地址

官方地址（安全无广告）：maven.apache.org/download.cg…

步骤2：选择合适的 Maven 版本（新手推荐）

  1. 无需追求最新版本，优先选择 3.6.x 或 3.8.x 版本（稳定、适配所有 JDK8+，兼容性最好）；

  2. 下载对应系统的压缩包（无需安装程序，解压即可用）：

  • Windows 系统：选择 apache-maven-3.8.8-bin.zip（zip 格式，解压后直接使用）；

  • Mac/Linux 系统：选择 apache-maven-3.8.8-bin.tar.gz（tar 格式，解压方式略有不同，下文会补充）；

  1. 下载位置：找到页面“Files”栏，下拉找到对应版本的压缩包，点击直接下载（无需登录，无需注册，浏览器直接下载即可）。

步骤3：确认下载完成

下载完成后，找到压缩包（默认在浏览器“下载”文件夹），核对文件名（确保是“bin.zip”/“bin.tar.gz”，不要下载成“source.zip”源码包，否则无法使用）。

三、Maven 安装（解压即安装，零复杂操作）

Windows 系统安装（最常用，重点讲解）

  1. 新建一个文件夹（用于存放 Maven，路径无中文/空格），比如：D:\Maven\apache-maven-3.8.8；

  2. 右键下载好的 zip 压缩包，选择“解压到”，找到刚才新建的文件夹，点击“确定”；

  3. 解压完成后，进入文件夹，确认目录结构：里面有 bin、conf、lib 等文件夹（这是 Maven 正常运行的核心目录，缺一不可）。

Mac/Linux 系统安装（补充）

  1. 打开终端，进入下载目录（默认是 ~/Downloads）：cd ~/Downloads；

  2. 解压 tar 压缩包：tar -zxvf apache-maven-3.8.8-bin.tar.gz；

  3. 移动解压后的文件夹到指定路径（无中文/空格），比如：sudo mv apache-maven-3.8.8 /usr/local/maven（输入电脑密码即可完成移动）。

四、Maven 核心配置（关键步骤，决定能否正常使用）

配置分为两步：环境变量 配置（让系统识别 Maven 命令）、核心配置文件修改（配置国内镜像，解决下载慢问题，新手必做）。

第一步：配置环境变量（Windows 系统）

和配置 JDK 环境变量步骤类似，全程图形化操作，一步不落地来：

  1. 右键「此电脑」→「属性」→「高级系统设置」→「高级」→「环境变量」；

  2. 在「系统变量」区域操作（所有用户生效，推荐），点击「新建」；

  3. 新建 MAVEN_HOME 变量：

  • 变量名：MAVEN_HOME（必须大写，不能错）；

  • 变量值：Maven 解压后的根目录（比如 D:\Maven\apache-maven-3.8.8，复制解压文件夹的路径，直接粘贴即可，不要多打空格）；

  1. 编辑 Path 变量：

  • 在系统变量中找到 Path，双击打开；

  • 点击「新建」，输入：%MAVEN_HOME%\bin；

  • 点击「上移」，把这一行放到 Path 列表的顶部（避免和其他软件冲突）；

  1. 保存配置：点击所有弹出窗口的「确定」，环境变量配置完成（切记：配置后必须重启 CMD，否则配置不生效）。

补充：Mac/Linux 系统配置环境变量

  1. 打开终端，编辑配置文件：vim ~/.bash_profile（Mac 最新系统用 vim ~/.zshrc）；

  2. 按 i 进入编辑模式，添加以下内容（路径替换成自己的 Maven 解压路径）：

export MAVEN_HOME=/usr/local/maven
export PATH=$MAVEN_HOME/bin:$PATH

  1. 按 Esc，输入 :wq 保存并退出；

  2. 生效配置：source ~/.bash_profile（Mac 最新系统用 source ~/.zshrc）。

第二步：修改 Maven 核心配置文件（配置国内镜像，必做）

Maven 默认使用国外镜像，下载依赖速度极慢，甚至失败，因此必须配置国内镜像（推荐阿里云镜像，稳定且速度快）。

  1. 找到 Maven 解压目录下的 conf 文件夹，打开里面的 settings.xml 文件（用记事本、Notepad++、IDEA 等编辑器打开均可）；

  2. 找到 <mirrors> 标签（在文件中间位置，可按Ctrl+F搜索“”快速定位），在该标签内部（<mirrors> 和 </mirrors> 之间），添加阿里云镜像配置（复制下面的代码，直接粘贴即可，无需修改，同时增加备用镜像，避免单个镜像失效）：

<!-- 阿里云主镜像（优先使用，稳定快速） -->
<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>central</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>
<!-- 阿里云备用镜像（主镜像失效时自动切换） -->
<mirror>
    <id>aliyunmaven2</id>
    <mirrorOf>*</mirrorOf>
    <name>阿里云中央仓库备用</name>
    <url>https://maven.aliyun.com/nexus/content/groups/public/</url>
</mirror>
  1. （可选，推荐）配置本地仓库：本地仓库用于存放下载的依赖包，默认在 C 盘，可修改到其他磁盘（避免占用 C 盘空间），配置后，阿里云镜像下载的依赖会自动存到该目录，方便后续复用。

找到 <localRepository> 标签（默认被注释掉，搜索关键词即可），修改为自己新建的本地仓库路径（路径无中文/空格），示例：

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

注意：新建 maven-repository 文件夹（路径自己定，比如 D 盘、E 盘均可），然后把路径复制到配置文件中。

  1. 保存配置文件：修改完成后，保存并关闭settings.xml（确保没有修改错标签，否则会报错）。

五、CMD 命令验证（关键一步，确认配置成功）

配置完成后，必须重启 CMD（Windows）或终端（Mac/Linux），否则环境变量不生效，验证步骤如下：

步骤1：打开 CMD/终端

  • Windows：Win+R，输入 cmd，回车；

  • Mac/Linux：直接打开终端。

步骤2：执行验证命令

输入命令：mvn -v（注意：mvn 和 -v 之间有一个空格，不能省略），然后回车。

步骤3：判断是否成功

✅ 成功输出（类似以下内容，版本号和路径对应自己的配置即可）：

Apache Maven 3.8.8 (4c87b05d9aedce574290d1acc98575ed5eb6cd39)
Maven home: D:\Maven\apache-maven-3.8.8
Java version: 1.8.0_482, vendor: Temurin, runtime: D:\Java\jdk8u482-b08\jre
Default locale: zh_CN, platform encoding: GBK
OS name: "windows 10", version: "10.0", arch: "amd64", family: "windows"

❌ 失败情况及解决：

  1. 提示「'mvn' 不是内部或外部命令」：检查 MAVEN_HOME 路径是否正确、Path 中是否添加 %MAVEN_HOME%\bin，重启 CMD 再试；

  2. 提示 JDK 相关错误：检查 JDK 是否配置成功（java -version 验证），确保 JDK 版本和 Maven 版本适配；

  3. 提示配置文件错误：检查 settings.xml 文件，确保镜像标签、本地仓库标签没有写错（比如缺少尖括号）。

六、额外验证（可选，确保能正常下载依赖）

如果想进一步确认 Maven 能正常使用，可执行以下命令，测试依赖下载：

  1. 打开 CMD/终端，输入命令：mvn help:system；

  2. 执行后，Maven 会自动下载所需的基础依赖包（如果配置了国内镜像，下载速度会很快）；

  3. 无报错、能正常下载完成，说明 Maven 配置完全生效，可用于 Java 项目开发。

七、常见问题排查（新手必看，避免踩坑）

  1. 路径包含中文/空格：导致环境变量配置失败、命令报错，重新解压 Maven 到无中文/空格的路径，重新配置环境变量；

  2. 镜像配置不生效：检查 settings.xml 文件中，镜像标签是否放在 <mirrors> 内部，没有写错标签，保存后重启 CMD；

  3. 本地仓库无法创建：路径错误或权限不足，重新新建本地仓库文件夹，修改 settings.xml 中的路径，确保路径正确；

  4. Maven 版本和 JDK 不兼容：JDK8 对应 Maven 3.6+，JDK11 对应 Maven 3.8+，重新下载对应版本的 Maven 即可。

八、总结

Maven 核心流程：下载（bin 压缩包）→ 解压（无中文路径）→ 配置环境变量（MAVEN_HOME + Path）→ 修改 settings.xml（国内镜像+本地仓库）→ 命令验证（mvn -v），全程无复杂操作，新手只要严格按照步骤来，就能一次性配置成功。

配置完成后，即可在 IDEA、Eclipse 等开发工具中关联 Maven，用于 Java 项目的依赖管理和编译打包。

avatar
文章
阅读
粉丝