在这里插入图片描述

📃个人主页：编程的一拳超人

⛺️ 欢迎关注：👍点赞 👂🏽留言 😍收藏 💞 💞 💞

于高山之巅，方见大河奔涌；于群峰之上，更觉长风浩荡。 ——《人民日报》

🎉Maven 详解与安装配置指南（任何版本都可以依据本文章配置）

一、Maven 是什么？✨

Apache Maven 是一个基于 POM（Project Object Model）的项目管理和构建工具，主要用于 Java 项目（也支持其他语言）。它通过标准化项目结构和配置文件，自动化管理依赖、编译、测试、打包和部署流程。

1、POM 文件（pom.xml）🎊

项目的核心配置文件，定义依赖、插件、构建规则等。

🪄示例片段：

<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>5.3.0</version>
    </dependency>
</dependencies>

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配置复制进去

        <mirror>
            <id>maven-default-http-blocker</id>
            <mirrorOf>external:http:*</mirrorOf>
            <name>Pseudo repository to mirror external repositories initially using HTTP.</name>
            <url>http://0.0.0.0/</url>
            <blocked>true</blocked>
        </mirror>

        <!-- 阿里云镜像central库 -->
        <!-- central Maven中央库（默认仓库），加速访问Java标准库（如commons-*、log4j等），最常用的公共依赖仓库，包含绝大多数开源Java库 -->
        <mirror>
            <id>aliYunMaven</id>
            <name>aliyun maven</name>
            <mirrorOf>central</mirrorOf>
            <url>https://maven.aliyun.com/repository/central</url>
        </mirror>

        <!-- 阿里云镜像public库 -->
        <!-- public 同时代理两个仓库的依赖：central + jcenter聚合仓，简化配置，一次引用多个源（但可能增加依赖冲突风险）     -->
        <mirror>
            <id>aliyunmaven</id>
            <mirrorOf>*</mirrorOf>
            <name>阿里云公共仓库</name>
            <url>https://maven.aliyun.com/repository/public</url>
        </mirror>


        <!--清华大学镜像 -->
        <mirror>
            <id>tsinghuaUniversityMaven</id>
            <name>tsinghuaUniversity Maven</name>
            <mirrorOf>external:http:*</mirrorOf>
            <url>https://repo.maven.apache.org/maven2/</url>
        </mirror>

        <!--华为镜像 -->
        <mirror>
            <id>huaWeiMaven</id>
            <name>huaWei Maven</name>
            <mirrorOf>external:http:*</mirrorOf>
            <url>https://repo.huaweicloud.com/repository/maven/</url>
        </mirror>

3、文件配置--配置profiles

在两个profiles标签中间

      <profile>
            <!-- 定义 profile 的唯一 id -->
            <id>jdk-1.8</id>
            <!-- 定义 profile 的激活条件 -->
            <activation>
                <!-- 设置为默认激活 -->
                <activeByDefault>true</activeByDefault>
                <!-- 当 JDK 版本为 1.8 时激活 -->
                <jdk>1.8</jdk>
            </activation>
            <!-- 定义 profile 的属性配置 -->
            <properties>
                <!-- 设置 Java 源代码版本为 1.8 -->
                <maven.compiler.source>1.8</maven.compiler.source>
                <!-- 设置 Java 目标版本为 1.8 -->
                <maven.compiler.target>1.8</maven.compiler.target>
                <!-- 设置编译器版本为 1.8 -->
                <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
            </properties>
        </profile>

四、配置环境变量

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 中通过 <exclusions> 排除冲突依赖。

七、总结

Maven 优势：标准化、自动化、依赖管理强大。
适用场景：Java 项目构建、多模块管理、团队协作。
学习建议：从简单项目开始，逐步掌握 pom.xml 配置和生命周期。

通过以上步骤，你已成功安装并配置 Maven！接下来可以创建第一个 Maven 项目

2025年最新版最细致Maven安装与配置指南（任何版本都可以依据本文章配置）