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

安装配置

Windows 安装步骤

步骤 1：解压文件

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

步骤 2：设置环境变量

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

2. 在"系统变量"中新建：

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

3. 编辑 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：手动安装

1. 解压文件：

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

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

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

3. 重新加载配置：

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 安装目录有读取权限

← 返回首页 ← 上一章：Maven 教程下一章：Maven POM →