Maven 环境配置

系统要求

Java：JDK 8 或更高版本（推荐 JDK 11 或 17）
内存：至少 512MB RAM
磁盘空间：至少 10MB 用于 Maven 安装
操作系统：Windows、Linux、macOS

注意：Maven 3.8.9 需要 Java 8 或更高版本。请确保已正确安装和配置 Java 环境。

检查 Java 环境

在安装 Maven 之前，请确认 Java 已正确安装：


java -version
javac -version

下载 Maven

步骤 1：下载 Maven 3.8.9

访问 Apache Maven 官网：https://maven.apache.org/download.cgi

下载 apache-maven-3.8.9-bin.zip 或 apache-maven-3.8.9-bin.tar.gz

安装配置

WindowsLinuxmacOS

Windows 安装步骤

步骤 1：解压文件

将下载的 zip 文件解压到 C:\Program Files\Apache\maven

步骤 2：设置环境变量

右键"此电脑" → "属性" → "高级系统设置" → "环境变量"
在"系统变量"中新建：


变量名：MAVEN_HOME
变量值：C:\Program Files\Apache\maven\apache-maven-3.8.9

编辑 PATH 变量，添加：


%MAVEN_HOME%\bin

步骤 3：验证安装

打开命令提示符，执行：


mvn -version

Linux 安装步骤

步骤 1：解压文件


sudo tar -xzf apache-maven-3.8.9-bin.tar.gz -C /opt/
sudo ln -s /opt/apache-maven-3.8.9 /opt/maven

步骤 2：设置环境变量

编辑 ~/.bashrc 或 ~/.profile：


export MAVEN_HOME=/opt/maven
export PATH=$MAVEN_HOME/bin:$PATH

重新加载配置：


source ~/.bashrc

步骤 3：验证安装


mvn -version

macOS 安装步骤

方法 1：使用 Homebrew（推荐）


brew install maven

方法 2：手动安装

解压文件：


sudo tar -xzf apache-maven-3.8.9-bin.tar.gz -C /usr/local/
sudo ln -s /usr/local/apache-maven-3.8.9 /usr/local/maven

设置环境变量（编辑 ~/.zshrc 或 ~/.bash_profile）：


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

重新加载配置：


source ~/.zshrc

验证安装


mvn -version

配置 Maven

1. 配置本地仓库

编辑 $MAVEN_HOME/conf/settings.xml：


<localRepository>/path/to/local/repo</localRepository>

2. 配置镜像源（可选）

为了加快下载速度，可以配置国内镜像：


<mirrors>
  <mirror>
    <id>aliyun</id>
    <mirrorOf>central</mirrorOf>
    <name>Aliyun Central</name>
    <url>https://maven.aliyun.com/repository/central</url>
  </mirror>
</mirrors>

3. 配置代理（如需要）


<proxies>
  <proxy>
    <id>my-proxy</id>
    <active>true</active>
    <protocol>http</protocol>
    <host>proxy.company.com</host>
    <port>8080</port>
  </proxy>
</proxies>

验证安装

执行以下命令验证 Maven 是否正确安装：


mvn -version

成功输出示例：


Apache Maven 3.8.9 (xxxxxxx)
Maven home: /path/to/maven
Java version: 11.0.x, vendor: Eclipse Adoptium
Java home: /path/to/java
Default locale: zh_CN, platform encoding: UTF-8
OS name: "mac os x", version: "12.x", arch: "x86_64", family: "mac"

常见问题

1. 命令未找到

检查环境变量 PATH 是否正确配置

2. Java 版本不兼容

确保使用 JDK 8 或更高版本

3. 权限问题

确保对 Maven 安装目录有读取权限