linux怎么安装maven_linux配置项目构建工具【实战】

落伟酱_7226

落伟酱_7226

2026-03-14

302人浏览

原创

先运行 mvn -v 检查是否预装及版本,若未安装或版本低于 3.8.0 则需升级;推荐用 SDKMAN! 安装管理多版本,次选手动解压配置环境变量与阿里云镜像源,并确保 JDK 版本与 Maven 兼容。

linux怎么安装maven_linux配置项目构建工具【实战】

检查系统是否已预装 Maven

很多 Linux 发行版(尤其是 Ubuntu/Debian 的某些桌面镜像或开发环境)会自带 mvn,但版本往往过旧(比如 3.6.x),甚至只是 maven 包的空壳,实际没装 mvn 命令。直接运行 mvn -v,如果报 command not found,说明没装;如果输出版本但低于 3.8.0,大概率不兼容较新项目的 pom.xml(比如用了 中的 BOM 导入方式时会失败)。

实操建议:

  • 先执行 which mvn 和 mvn -v 确认是否存在、路径在哪、版本号是多少
  • Ubuntu/Debian 用户别急着 sudo apt install maven —— 官方源的 maven 包通常滞后 2~3 个大版本,且依赖 OpenJDK 11,和你本地 JDK 17/21 可能冲突
  • CentOS/RHEL 8+ 用户注意:dnf install maven 装的是 maven-local,它不提供 mvn 全局命令,而是用于构建 RPM 包的内部工具,不是你要的 Apache Maven

用 SDKMAN! 安装并管理多个 Maven 版本

这是最省心、最贴近 Java 开发者真实工作流的方式。SDKMAN! 不仅能装 maven,还能同时共存 maven 3.8.8、3.9.6、4.0.0-alpha-5,并一键切换,避免项目间因 Maven 版本差异导致的 Could not resolve dependencies 或 Unknown lifecycle phase "package" 错误。

实操建议:

  • 运行 curl -s "https://get.sdkman.io" | bash,然后 source "$HOME/.sdkman/bin/sdkman-init.sh"
  • 执行 sdk list maven 查看可用版本(带 * 的是推荐稳定版,如 3.9.6)
  • 装指定版本:sdk install maven 3.9.6,之后 mvn -v 就能确认生效
  • 若需临时切版本(比如调试老项目),用 sdk use maven 3.8.8,退出终端即恢复默认

手动解压安装(适合离线/受限环境)

当无法联网或公司内网禁止外部包管理器时,这是唯一可靠方式。关键不是“下载完解压就行”,而是路径、权限和环境变量三者必须对齐,否则 mvn 找不到 tools.jar 或报 JAVA_HOME not set(即使 java -version 正常)。

易企秀
易企秀

易企秀是一款面向企业营销活动、H5 页面和视觉内容制作的在线设计平台。

下载

实操建议:

  • 从 Maven 官网 下载 apache-maven-3.9.6-bin.tar.gz(别下 -src 或 -zip)
  • 解压到非用户主目录的统一位置,例如 /opt/maven:sudo tar -xzf apache-maven-3.9.6-bin.tar.gz -C /opt/ && sudo ln -sf /opt/apache-maven-3.9.6 /opt/maven
  • 在 /etc/profile.d/maven.sh 中写入:
    export MAVEN_HOME=/opt/maven<br>export PATH=$MAVEN_HOME/bin:$PATH
    ,然后 source /etc/profile.d/maven.sh
  • 验证:运行 mvn -v,输出中 Maven home 必须显示 /opt/maven,且 Java version 和你 $JAVA_HOME 一致

配置 settings.xml 避免首次构建卡住

刚装好的 Maven 第一次跑 mvn clean compile 会卡在 Downloading from central,不是网络慢,而是默认中央仓库(https://repo.maven.apache.org/maven2/)在国内直连极慢,且没配镜像源。更隐蔽的问题是:如果你用 IDE(如 IntelliJ)导入项目,它可能读取的是 ~/.m2/settings.xml,而命令行用的是 $MAVEN_HOME/conf/settings.xml,两者不一致会导致依赖解析行为不一致。

实操建议:

  • 优先修改全局配置:sudo cp $MAVEN_HOME/conf/settings.xml /opt/maven/conf/settings.xml,再编辑该文件,在 标签下插入阿里云镜像:
<mirror><id>aliyunmaven</id><mirrorof>*</mirrorof><name>Aliyun Maven</name><url>https://maven.aliyun.com/repository/public</url></mirror>
  • 确认 ~/.m2/settings.xml 不存在,或软链到全局配置:ln -sf /opt/maven/conf/settings.xml ~/.m2/settings.xml
  • 删掉 ~/.m2/repository(第一次配置后可选),让 Maven 重新拉取索引和依赖,验证是否提速

Maven 的麻烦不在安装本身,而在版本、JDK、镜像源、IDE 配置这四者的隐式耦合——改其中一项,其他三项都可能跟着出问题。动手前先 echo $JAVA_HOME 和 mvn -v 对齐,比重装十遍都管用。

相关文章

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

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

下载

相关标签:

linux配置

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

相关专题

更多
Java Maven专题
Java Maven专题

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

2025.09.15

4920

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

409

25

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.01

5284

5

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2024.08.01

6877

7

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

2024.11.28

2682

7

curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

2023.06.14

4003

6

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

2023.10.30

975

4

http与https有哪些区别
http与https有哪些区别

http与https的区别:1、协议安全性;2、连接方式;3、证书管理;4、连接状态;5、端口号;6、资源消耗;7、兼容性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.08.16

5650

6

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

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

2023.06.21

4650

4

热门下载

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

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习