Linux怎么安装配置Apache Maven构建工具

夏敏同学_7727

夏敏同学_7727

2026-11-05

315人浏览

原创

Linux安装Maven本质是解压+配环境变量,核心三步:确认JDK 8+已安装并正确配置JAVA_HOME;下载官方二进制包(如3.9.12)并解压至/opt等规范路径;配置MAVEN_HOME与PATH后source生效;最后修改~/.m2/settings.xml配置阿里云镜像及本地仓库路径。

linux怎么安装配置apache maven构建工具

Linux上装Maven不是“安装”,是解压+配环境变量,核心就三步:确认JDK已就位、下载解压二进制包、把mvn命令加进PATH。跳过任一环节都会导致mvn: command not found或Unsupported Java version报错。

确认JDK已正确安装并生效

Maven 3.8+ 要求 JDK 8 或更高版本,且必须配置JAVA_HOME——这不是可选项,是硬性前提。很多用户卡在mvn -v报错“Java version is not supported”,其实问题出在Java本身没配好。

  • 运行java -version和which java,确认输出的是你期望的JDK路径(比如/usr/lib/jvm/java-17-openjdk-amd64/bin/java)
  • 检查JAVA_HOME是否指向JDK根目录(不是jre子目录),例如:echo $JAVA_HOME 应输出/usr/lib/jvm/java-17-openjdk-amd64
  • 如果JAVA_HOME为空或错误,先在/etc/profile或~/.bashrc里补上:export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64,再执行source重载

下载解压Maven二进制包(别用包管理器)

系统包管理器(如apt install maven)装的通常是旧版(Ubuntu 24.04 默认还是 3.6.x),且settings.xml位置不标准,后续改镜像、换本地仓库会踩坑。直接下官方二进制包最可控。

  • 选稳定版:截至2026年9月,推荐用apache-maven-3.9.12-bin.tar.gz(官网最新LTS级版本)
  • 下载命令(国内建议用华为源加速):wget https://repo.huaweicloud.com/apache/maven/maven-3/3.9.12/binaries/apache-maven-3.9.12-bin.tar.gz
  • 解压到规范路径(避免空格/中文):sudo tar -zxvf apache-maven-3.9.12-bin.tar.gz -C /opt/ → 得到/opt/apache-maven-3.9.12

配置MAVEN_HOME和PATH(全局 or 当前用户?)

配错位置会导致root能用、普通用户不能用,或者重启后失效。关键看你是单用户开发还是多用户服务器环境。

Linux Security Scanner
Linux Security Scanner

Linux 安全审计工具,检查 SSH 配置、开放/监听端口、防火墙规则(ufw/iptables/nftables)、失败登录尝试、sudoers 权限...

下载
  • 单用户开发(推荐):写入~/.bashrc或~/.zshrc(根据shell类型):
    export MAVEN_HOME=/opt/apache-maven-3.9.12
    export PATH=$PATH:$MAVEN_HOME/bin
  • 多用户/系统级部署:写入/etc/profile.d/maven.sh(新建文件,非/etc/profile末尾追加),并确保有执行权限:sudo chmod +x /etc/profile.d/maven.sh
  • 无论哪种方式,执行source ~/.bashrc(或对应文件)立即生效,不要靠新开终端“碰运气”

验证并快速初始化settings.xml(绕过默认中央仓库慢)

mvn -v能显示版本只是第一步;真正要用起来,必须改conf/settings.xml,否则第一次mvn compile会卡死在下载依赖上。

  • 先复制模板:cp /opt/apache-maven-3.9.12/conf/settings.xml ~/.m2/settings.xml(用户级配置优先于全局)
  • 编辑~/.m2/settings.xml,在标签内加阿里云镜像(2026年仍稳定):
    <mirror><id>aliyunmaven</id><mirrorof>*</mirrorof><name>Aliyun Maven</name><url>https://maven.aliyun.com/repository/public</url></mirror>
  • 顺手改本地仓库路径(避免占满/root或/home):/data/m2repo,然后mkdir -p /data/m2repo

最关键的细节往往藏在路径和权限里:解压目录不能是/tmp这种临时路径,settings.xml必须放在~/.m2/(不是conf/下),而/data/m2repo这类自定义仓库目录得确保当前用户有读写权限——这些点不检查,mvn命令能跑,但一拉依赖就静默失败。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

2025.09.15

4400

19

Java Maven/Gradle 构建与依赖管理合集
Java Maven/Gradle 构建与依赖管理合集

系统讲解 Java 项目构建工具的使用与进阶配置,涵盖 Maven 的 POM 文件结构、生命周期(clean/compile/package/install/deploy)与插件机制、依赖范围(compile/provided/test/runtime)与传递依赖管理、多模块聚合与继承、私有 Nexus 仓库发布,以及 Gradle 的 Groovy / Kotlin DSL 语法、Task 自定义与增量构建、依赖版本目录(Versi

2026.05.09

389

25

磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

2023.06.21

4410

4

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

2023.06.29

3693

10

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

2023.06.30

2973

5

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

2023.07.05

7350

7

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

2023.07.06

6982

7

linux查看文件夹大小
linux查看文件夹大小

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。linux怎么查看文件夹大小呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.20

3993

8

linux查看ip命令
linux查看ip命令

本专题为大家提供linux查看ip命令相关文章内容,感兴趣的朋友可以免费下载体验试试。

2023.07.20

3485

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习