CentOS安装Maven详细教程

文章目录

• • [✅ 第一步：检查 Java 环境](#✅ 第一步：检查 Java 环境)
  • • [如果未安装 Java：](#如果未安装 Java：)
  • [✅ 第二步：下载 Maven 安装包](#✅ 第二步：下载 Maven 安装包)
  • • [方法 1：使用 `wget` 下载（推荐）](#方法 1：使用 wget 下载（推荐）)
    • [方法 2：使用国内镜像加速下载](#方法 2：使用国内镜像加速下载)
  • [✅ 第三步：配置环境变量](#✅ 第三步：配置环境变量)
  • • [1. 编辑系统环境变量文件](#1. 编辑系统环境变量文件)
    • [2. 在文件末尾添加以下内容（根据实际路径调整）：](#2. 在文件末尾添加以下内容（根据实际路径调整）：)
    • [3. 保存并退出编辑器（按 `Esc`，输入 `:wq` 回车）。](#3. 保存并退出编辑器（按 Esc，输入 :wq 回车）。)
    • [4. 使配置立即生效](#4. 使配置立即生效)
  • [✅ 第四步：验证 Maven 安装](#✅ 第四步：验证 Maven 安装)
  • [✅ 第五步：配置 Maven 本地仓库和镜像](#✅ 第五步：配置 Maven 本地仓库和镜像)
  • • [1. 修改 Maven 配置文件](#1. 修改 Maven 配置文件)
    • [2. 配置本地仓库路径（可选）](#2. 配置本地仓库路径（可选）)
    • [3. 配置阿里云镜像（推荐国内用户）](#3. 配置阿里云镜像（推荐国内用户）)
    • [4. 保存并退出编辑器（`:wq`）。](#4. 保存并退出编辑器（:wq）。)
  • [✅ 第六步：测试 Maven 功能](#✅ 第六步：测试 Maven 功能)
  • • [创建一个简单的 Maven 项目：](#创建一个简单的 Maven 项目：)
  • [🚨 常见问题及解决方法](#🚨 常见问题及解决方法)
  • [✅ 总结](#✅ 总结)

在 CentOS 系统中安装 Maven 工具的完整步骤如下，涵盖 Java 环境检查、Maven 下载与配置、环境变量设置、本地仓库配置 等关键环节。

---

✅ 第一步：检查 Java 环境

Maven 是基于 Java 的工具，必须确保系统已安装 Java。

# 检查 Java 是否已安装
java -version

如果未安装 Java：

# 安装 OpenJDK 8（推荐）
sudo dnf install -y java-1.8.0-openjdk-devel

# 或安装 OpenJDK 11
sudo dnf install -y java-11-openjdk-devel

---

✅ 第二步：下载 Maven 安装包

方法 1：使用 wget 下载（推荐）

# 创建 Maven 安装目录（可选）
sudo mkdir -p /usr/local/maven

# 进入安装目录
cd /usr/local/maven

# 下载最新版本 Maven（以 3.9.6 为例）
sudo wget https://dlcdn.apache.org/maven/maven-3/3.9.11/binaries/apache-maven-3.9.11-bin.tar.gz

# 解压安装包
sudo tar -zxvf apache-maven-3.9.11-bin.tar.gz

方法 2：使用国内镜像加速下载

# 阿里云镜像（推荐国内用户）
sudo wget https://mirrors.aliyun.com/apache/maven/maven-3/3.9.11/binaries/apache-maven-3.9.11-bin.tar.gz

# 解压
sudo tar -zxvf apache-maven-3.9.11-bin.tar.gz

---

✅ 第三步：配置环境变量

1. 编辑系统环境变量文件

sudo vi /etc/profile

2. 在文件末尾添加以下内容（根据实际路径调整）：

# Maven 环境变量配置
export MAVEN_HOME=/usr/local/maven/apache-maven-3.9.11
export PATH=$MAVEN_HOME/bin:$PATH

3. 保存并退出编辑器（按 Esc，输入 :wq 回车）。

4. 使配置立即生效

source /etc/profile

---

✅ 第四步：验证 Maven 安装

# 检查 Maven 版本
mvn -v

预期输出：

Apache Maven 3.9.11 (3e54c93a704957b63ee3494413a2b544fd3d825b)
Maven home: /usr/local/maven/apache-maven-3.9.11
Java version: 1.8.0_451, vendor: Oracle Corporation, runtime: /usr/lib/jvm/jdk1.8.0_451/jre
Default locale: zh_CN, platform encoding: UTF-8
OS name: "linux", version: "6.12.0-120.el10.x86_64", arch: "amd64", family: "unix"

---

✅ 第五步：配置 Maven 本地仓库和镜像

1. 修改 Maven 配置文件

sudo vi /usr/local/maven/apache-maven-3.9.11/conf/settings.xml

2. 配置本地仓库路径（可选）

<localRepository>/opt/maven/repository</localRepository>

3. 配置阿里云镜像（推荐国内用户）

<mirrors>
  <mirror>
    <id>aliyunmaven</id>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
    <mirrorOf>central</mirrorOf>
  </mirror>
</mirrors>

4. 保存并退出编辑器（:wq）。

---

✅ 第六步：测试 Maven 功能

创建一个简单的 Maven 项目：

# 创建项目目录
mkdir ~/my-maven-project
cd ~/my-maven-project

# 使用 Maven 初始化项目
mvn archetype:generate -DgroupId=com.example \
                       -DartifactId=my-app \
                       -DarchetypeArtifactId=maven-archetype-quickstart \
                       -DinteractiveMode=false

# 编译项目
mvn compile

# 打包项目
mvn package

# 运行项目
java -cp target/my-app-1.0-SNAPSHOT.jar com.example.App

---

🚨 常见问题及解决方法

问题	解决方案
command not found: mvn	检查 /etc/profile 中 PATH 配置是否正确，运行 source /etc/profile
Maven 下载速度慢	使用阿里云镜像下载（如 https://mirrors.aliyun.com/apache/maven/...）
编译失败（Java 版本不匹配）	确保 JAVA_HOME 指向正确的 JDK 版本，检查 settings.xml 中的 JDK 配置

---

✅ 总结

步骤	内容
1. 检查 Java	确保系统已安装 Java（推荐 JDK 8 或 11）
2. 下载 Maven	从 Apache 官网或国内镜像下载 .tar.gz 包
3. 解压配置	解压到 /usr/local/maven 并配置 MAVEN_HOME
4. 验证安装	运行 mvn -v 确认安装成功
5. 配置镜像	修改 settings.xml 使用阿里云镜像加速依赖下载

---

✅ 完成！

现在您已成功在 CentOS 系统中安装并配置了 Maven。如果需要进一步优化（如配置私有仓库或代理），请参考 Maven 官方文档。