讲师中心 微信公众号
AI工具推荐 视频效率加速

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

夏敏同学_7727

夏敏同学_7727

发布时间:2026-11-05 12:57:26

|

315人浏览过

|

来源于php中文网

原创

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位置不标准,后续改镜像、换本地仓库会踩坑。直接下官方二进制包最可控。

Linux Security Scanner
Linux Security Scanner

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

下载
  • 选稳定版:截至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能用、普通用户不能用,或者重启后失效。关键看你是单用户开发还是多用户服务器环境。

  • 单用户开发(推荐):写入~/.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,在<mirrors></mirrors>标签内加阿里云镜像(2026年仍稳定):
    <mirror>
      <id>aliyunmaven</id>
      <mirrorOf>*</mirrorOf>
      <name>Aliyun Maven</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
  • 顺手改本地仓库路径(避免占满/root或/home):<localrepository>/data/m2repo</localrepository>,然后mkdir -p /data/m2repo

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

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

更多
Java Maven专题
Java Maven专题

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

4400

2025.09.15

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

389

2026.05.09

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

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

4410

2023.06.21

如何安装LINUX
如何安装LINUX

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

3693

2023.06.29

linux find
linux find

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

2973

2023.06.30

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

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

7350

2023.07.05

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

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

6982

2023.07.06

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

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

3993

2023.07.20

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

0

2026.11.05

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Linux网络安全之防火墙技术汇总
Linux网络安全之防火墙技术汇总

共31课时 | 4.2万人学习

ubuntu官方总文档
ubuntu官方总文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn