乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > Maven 安装教程

Maven 安装教程

当前时间： 1970-01-01 08:00:00 分类：办公文件 评论(0)
Maven 安装教程

前置条件：已装好 JDK8 / JDK11 / JDK17，配置好 JAVA_HOME，执行 java -version 验证正常。 下载地址：Apache Maven官网 https://maven.apache.org/download.cgi 稳定版选择：apache‑maven‑3.9.x‑bin.zip（Windows） / apache‑maven‑3.9.x‑bin.tar.gz（Linux）

Windows 安装步骤

  1. 解压把zip解压到无中文、无空格路径，示例：D:\dev\apache‑maven‑3.9.16

❌不要放在 D:\Program Files、D:\软件\maven 这类带空格/中文路径

  1. 配置系统环境变量此电脑 → 属性 → 高级系统设置 → 环境变量 在系统变量新建：
  • 变量名：MAVEN_HOME
  • 变量值：D:\dev\apache‑maven‑3.9.16（你的解压根目录）

编辑系统变量 Path，新增一条：

%MAVEN_HOME%\bin

全部窗口点确定保存。

  1. 验证安装（必须新开CMD/PowerShell）
mvn -v

输出版本、Java版本信息即成功。

Linux / Ubuntu 安装

# 下载wget https://archive.apache.org/dist/maven/maven-3/3.9.16/binaries/apache-maven-3.9.16-bin.tar.gz# 解压到 /optsudo tar -zxvf apache-maven-3.9.16-bin.tar.gz -C /opt/

编辑shell配置文件，Ubuntu24.04默认zsh：

vim ~/.zshrc# 如果是bash则 vim ~/.bashrc

末尾添加：

export MAVEN_HOME=/opt/apache-maven-3.9.16export PATH=$MAVEN_HOME/bin:$PATH

生效配置：

source ~/.zshrc# 验证mvn -v

⭐核心配置 settings.xml（必做，解决下载慢、C盘爆满）

推荐：复制 maven/conf/settings.xml 到用户目录 Windows：C:\Users\你的用户名\.m2\settings.xmlLinux：~/.m2/settings.xml用户目录下的settings优先级高于安装目录conf，升级maven不会丢失配置。

完整可用配置片段

<?xml version="1.0" encoding="UTF-8"?><settingsxmlns="http://maven.apache.org/SETTINGS/1.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"><!-- 1.自定义本地仓库，不要放C盘，改成你自己路径 --><localRepository>D:/dev/maven-repository</localRepository><!-- 2.阿里云镜像，国内加速 --><mirrors><mirror><id>aliyunmaven</id><mirrorOf>*</mirrorOf><name>阿里云公共仓库</name><url>https://maven.aliyun.com/repository/public</url></mirror></mirrors><!-- 3.编译JDK版本，按需修改 --><profiles><profile><id>jdk17</id><properties><maven.compiler.source>17</maven.compiler.source><maven.compiler.target>17</maven.compiler.target><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties></profile></profiles><activeProfiles><activeProfile>jdk17</activeProfile></activeProfiles></settings>

说明

  1. localRepository：maven下载的jar包全部存在这里，不要放在C盘，Windows路径用 / 或者 \\
  2. <mirrorOf>*</mirrorOf>：代表所有仓库请求全部走阿里云镜像，大幅提升下载速度。

IDEA 集成Maven

打开 IDEA → File → Settings → Build,Execution,Deployment → Build Tools → Maven

  • Maven home path：选择你的maven解压目录
  • User settings file：勾选，指向上面.m2/settings.xml
  • Local repository：会自动读取settings里配置的仓库路径，点Apply。

常见排错

  1. 'mvn' 不是内部或外部命令
    • 环境变量没生效：关闭全部终端，重新打开；检查MAVEN_HOME路径不能带末尾/；确认Path配置正确。
  2. 依赖下载超时：检查settings.xml镜像配置，网络可访问阿里云maven地址。
  3. 报错Unsupported class file major version：settings里profile的jdk版本和实际运行jdk版本不匹配。