CentOS安装Maven实践

更新时间：2025年09月15日 09:58:51 作者：刘一说

文章详细介绍了在CentOS系统上安装配置Maven的步骤：检查Java环境、下载解压Maven、设置环境变量与本地仓库、配置阿里云镜像加速,并提供常见问题解决方案及验证方法,确保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 官方文档。

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

CentOs7下配置yum源全攻略(建议收藏)
在CentOS 7系统中,YUM是核心的包管理工具,本文将详细介绍三种常见的YUM源配置方式,希望可以帮助系统管理员根据不同场景选择最适合的配置方案
2025-09-09
详解ubuntu安装CMake的几种方式
这篇文章主要介绍了详解ubuntu安装CMake的几种方式，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-08-08
解决Linux系统切换用户后只显示$问题
当我们在使用Linux系统切换用户后只显示$,所以本文将给大家详细介绍一下如何解决Linux系统切换用户后只显示$问题,文中有详细问题分析和解决方案,需要的朋友可以参考下
2023-10-10
linux中通过文件描述符获取文件绝对路径的方法
下面小编就为大家带来一篇linux中通过文件描述符获取文件绝对路径的方法。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2016-12-12
sersync实现数据实时同步的方法
下面小编就为大家分享一篇sersync实现数据实时同步的方法，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2017-12-12
Linux service无法使用系统环境变量的问题及解决
这篇文章主要介绍了Linux service无法使用系统环境变量的问题及解决方案，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-04-04
Centos安装php高版本
PHP（超文本预处理器）是一种通用开源脚本语言。主要适用于Web开发领域。用PHP做出的动态页面与其他的编程语言相比，PHP是将程序嵌入到HTML（标准通用标记语言下的一个应用）文档中去执行，执行效率比完全生成HTML标记的CGI要高许多，使代码运行更快。
2016-05-05
Linux centos7环境下tomcat安装教程
这篇文章主要为大家详细介绍了Linux centos7环境下tomcat的安装教程，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2017-03-03
Linux 6 下编译安装 PHP 5.6实例详解
这篇文章主要介绍了Linux 6 下编译安装 PHP 5.6实例详解的相关资料,需要的朋友可以参考下
2017-04-04
linux top命令详解
这篇文章主要介绍了linux top命令详解，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-02-02