maven安装

举报
yd_227606267 发表于 2026/10/17 22:24:02 2026/10/17
【摘要】 本文详细介绍了Maven的安装配置过程,包括与JDK的版本对应关系、下载方式(官网和国内网盘)、在Windows和Linux/Mac系统上的安装步骤、环境变量配置方法及其作用,以及安装验证和常见问题排解。通过本教程,读者可以轻松完成Maven的安装部署,为Java项目的构建和依赖管理打下基础。

1. 与JDK版本对应关系

Maven的不同版本需要与特定的JDK版本相匹配。以下是主要的Maven版本与所需JDK版本的对应关系:

Maven版本 所需JDK版本
Maven 4.x JDK 17+
Maven 3.9.x JDK 8+
Maven 3.8.x JDK 8+
Maven 3.6.x - 3.8.x JDK 7+
Maven 3.3.x JDK 7+
Maven 3.2.5 JDK 6+
Maven 3.0 - 3.2.4 JDK 5+
Maven 2.x JDK 1.4 - 1.7

::: tip 补充说明
更详细的Maven版本历史信息可以在官方文档中查看:[Maven版本历史]
:::

2. 下载

::: tip 温馨提示

当你无法访问maven官网时,可以在网盘中获取

:::

2.1 官网下载

  1. [访问Maven官方下载页面]

  2. 选择适合您操作系统的二进制压缩包:

    • apache-maven-[版本号]-bin.zip (Windows用户)
    • apache-maven-[版本号]-bin.tar.gz (Linux/Mac用户)

2.2 网盘下载

网盘中含有linux和windows 3.9.10安装包

3. 安装

3.1 Windows系统安装

  1. 解压下载的zip文件到您选择的目录
  2. 确保您的系统中已经正确安装了JDK
  3. 注意保存Maven解压后的路径,如:D:\Apache\maven

3.2 Linux/Mac系统安装

::: tip 温馨提示

建议将Maven安装在一个没有空格和中文的路径中,这可以避免潜在的路径问题。

:::

  1. 打开终端
  2. 使用以下命令解压tar.gz文件:
    tar -xzvf apache-maven-3.9.10-bin.tar.gz
    
  3. 将解压后的文件夹移动到适当的位置:
    sudo mv apache-maven-3.9.10 /opt/maven
    

4. 添加环境变量

配置环境变量是使Maven在命令行中全局可用的关键步骤。

4.1 Windows系统环境变量配置

  1. 右键点击"此电脑"或"我的电脑",选择"属性"
  2. 点击"高级系统设置"
  3. 在"系统属性"窗口中,选择"高级"选项卡,然后点击"环境变量"
  4. 在"系统变量"区域,点击"新建"按钮
  5. 创建一个名为MAVEN_HOME的新变量,其值为Maven的安装目录(例如:D:\Apache\maven)
  6. 编辑系统变量Path,点击"新建",添加%MAVEN_HOME%\bin
  7. 点击"确定"保存所有更改

4.2 Linux/Mac系统环境变量配置

  1. 编辑环境配置文件(根据您的shell选择适当的文件):

    # Bash用户
    nano ~/.bashrc
    
    # Zsh用户
    nano ~/.zshrc
    
  2. 在文件末尾添加以下内容:

    export MAVEN_HOME=/opt/maven
    export PATH=$PATH:$MAVEN_HOME/bin
    
  3. 保存并关闭文件

  4. 使环境变量生效:

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

4.3 环境变量作用

配置环境变量的主要作用包括:

  • 允许在命令行中全局访问Maven命令,不需要每次使用完整路径
  • 为其他依赖Maven的工具提供必要的配置信息
  • 让Maven知道JDK的安装位置(通过JAVA_HOME变量)
  • 便于多版本Maven的管理和切换

5. 验证安装

安装完成后,验证Maven是否正确安装并可以使用:

  1. 打开命令行终端(Windows的命令提示符或PowerShell,或Linux/Mac的终端)

  2. 输入以下命令:

    mvn -v
    
  3. 如果安装成功,您将看到类似以下的输出:

    Apache Maven 3.9.10 (5f519b97e944483d878815739f519b2eade0a91d)
    Maven home: /opt/maven
    Java version: 17.0.2, vendor: Oracle Corporation
    Java home: /usr/lib/jvm/java-17-openjdk
    Default locale: en_US, platform encoding: UTF-8
    OS name: "linux", version: "5.15.0", arch: "x86_64", family: "unix"
    

这表明Maven已成功安装,并且系统已正确配置环境变量。输出信息包含了Maven版本、Maven安装路径、Java版本与供应商、Java安装路径、默认区域设置、平台编码以及操作系统信息。

6. 常见问题排解

6.1 mvn不是内部或外部命令"错误

  • 原因:环境变量没有正确设置
  • 解决方法:检查PATH环境变量是否包含Maven的bin目录

6.2 Java相关错误

  • 原因:JDK未安装或JAVA_HOME环境变量未设置
  • 解决方法:安装兼容版本的JDK并设置JAVA_HOME环境变量
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。