📃个人主页：编程的一拳超人
CSDN 2025年最新版最细致Maven安装与配置指南（任何版本都可以依据本文章配置）
⛺️ 欢迎关注：👍点赞 👂🏽留言 😍收藏 💞 💞 💞
于高山之巅，方见大河奔涌；于群峰之上，更觉长风浩荡。 ——《人民日报》
🎉Maven 详解与安装配置指南（任何版本都可以依据本文章配置）
一、Maven 是什么？✨
Apache Maven 是一个基于 POM（Project Object Model） 的 项目管理和构建工具，主要用于 Java 项目（也支持其他语言）。它通过标准化项目结构和配置文件，自动化管理依赖、编译、测试、打包和部署流程。
1、POM 文件（pom.xml）🎊
项目的核心配置文件，定义依赖、插件、构建规则等。
🪄示例片段：
2、依赖管理🎊
自动从仓库（如 Maven Central）下载和管理 JAR 文件。
解决版本冲突，传递性依赖。
3、构建生命周期🎊
默认生命周期（clean、compile、test、package、install、deploy）。
通过插件（Plugins）扩展功能（如 maven-compiler-plugin）。
4、仓库（Repository）🎊
本地仓库：本地缓存依赖（默认在 ~/.m2/repository）。
远程仓库：如 Maven Central、阿里云镜像等。
二、Maven的下载、安装、配置与设置环境变量✨
1、下载 Maven🔮
官网下载地址：https://maven.apache.org/download.cgi
选择二进制包（如 apache-maven-3.9.10-bin.zip，要用就用最新的，现在这个版本对我来说是最新的）。
2、解压到本地目录🔮
(1) Linux/macOS
unzip apache-maven-3.9.10-bin.zip -d /opt/maven
(2) Windows系统
直接解压到 Windows 的路径下
例如：`D:\develop_tools\Maven\apache-maven-3.9.10`
3、配置本地仓库🔮
本地仓库（Local Repository）在Maven中扮演着重要的角色，是Maven工作原理的一个关键部分。
(1) 优点🪄
缓存依赖：
当第一次运行Maven命令来构建项目时，Maven会从远程仓库（如中央仓库）下载项目所依赖的库（jar文件）到本地仓库。这些依赖被缓存在本地仓库中，以便于未来的构建可以重用，不需要再次从远程仓库下载，节省时间。
离线工作：
如果没有网络连接或者远程仓库不可用，Maven可以从本地仓库获取依赖，可以在离线状态下构建项目。
减少网络流量：
由于依赖一旦下载就会存储在本地仓库中，因此在项目开发过程中，重复构建时不需要多次下载相同的依赖，减少网络流量和远程仓库的负载。
自定义依赖管理：
可以将自己的项目构件（如jar文件）安装到本地仓库中，这样其他项目就可以通过Maven依赖机制使用这些构件，方便了项目的共享和重用。
版本控制：
本地仓库会存储不同版本的依赖，可以轻松地在项目中切换依赖的版本，不用担心其他项目的干扰。
提高构建速度：
本地仓库通常位于本地硬盘上，访问速度远快于远程仓库，可以显著提高项目构建的速度。
自定义仓库配置：
可以配置多个本地仓库，例如，为不同的项目或不同的环境设置不同的本地仓库，以更好地管理依赖。
(2) 创建本地仓库实操 🪄
找到之前解压的 D:\develop_tools\Maven\ 文件，新建一个 maven_repository文件夹作为本地的仓库，如下图：
D:\develop_tools\Maven\maven_repository
三、配置Maven：配置settings.xml 文件🪄
1、文件路径
路径为maven解压的路径
D:\develop_tools\Maven\apache-maven-3.9.10\conf\settings.xml
2、文件配置--配置镜像仓库
在两个mirrors标签中间将我的镜像mirror配置复制进去
3、文件配置--配置profiles
在两个profiles标签中间
四、配置环境变量
1、Windows系统
右键 此电脑 → 属性 → 高级系统设置 → 环境变量。
在 系统变量 中：
新建变量 MAVEN_HOME，值为 Maven 解压路径（如 D:\develop_tools\Maven\apache-maven-3.9.10）。
编辑 Path 变量，添加 %MAVEN_HOME%\bin。
验证：进度cmd命令，win+R
mvn -v
4.在第二步时，第一次配置的话，点击新建，名字和我这个一样，不是第一次直接编辑
上面配置完，在进行下图
%MAVEN_HOME%\bin
设置完点击确定，windows环境变量配置成功
2、Linux/macOS
编辑 ~/.bashrc 或 ~/.zshrc：export MAVEN_HOME=/opt/maven/apache-maven-3.9.10
export PATH=$MAVEN_HOME/bin:$PATH
生效配置：source ~/.bashrc
验证：mvn -version
五、Maven 基础命令✨
命令
作用
mvn clean
清理 target 目录
mvn compile
编译源代码
mvn test
运行单元测试
mvn package
打包（生成 JAR/WAR）
mvn install
安装到本地仓库
mvn deploy
部署到远程仓库（需配置）
mvn dependency:tree
查看依赖树
六、常见问题解决🔒
1、下载依赖慢
检查镜像配置（如阿里云）。
删除本地仓库中不完整的依赖（~/.m2/repository）。
2、环境变量不生效
确保 PATH 中包含配置的路径
Windows：%MAVEN_HOME%\bin
Linux/macOS $MAVEN_HOME/bin。
重启终端或 IDE。3、版本冲突
使用 mvn dependency:tree 分析依赖树。
在 pom.xml 中通过
七、总结
Maven 优势：标准化、自动化、依赖管理强大。
适用场景：Java 项目构建、多模块管理、团队协作。
学习建议：从简单项目开始，逐步掌握 pom.xml 配置和生命周期。
通过以上步骤，你已成功安装并配置 Maven！接下来可以创建第一个 Maven 项目