Maven 完整配置与使用技术笔记

一、前言

本文整理了Maven 下载安装、环境配置、阿里云镜像加速、IDEA 集成、依赖库引入的全流程步骤，零基础也能快速上手，解决 Java 项目依赖管理、打包构建的核心问题，适配所有 Java 开发场景（如 SpringBoot、普通 Java 项目）。

二、Maven 下载与安装

1. 下载 Maven 安装包

下载地址：https://maven.apache.org/download.cgi(https://maven.apache.org/download.cgi)
选择版本：** apache-maven-3.9.15-bin.zip**
无需安装，直接解压即可使用。

2. 解压存放（核心步骤）

在电脑 D 盘根目录 新建文件夹，命名为 Maven（纯英文路径，无空格、无中文）；
将下载的 maven-xxx-bin.zip 解压到 D:\Maven 目录下；
最终目录结构：D:\Maven\apache-maven-3.8.8。

3. 配置系统环境变量

步骤 1：复制 Maven 可执行文件路径

打开 D:\Maven\apache-maven-3.8.8\bin 文件夹，复制完整路径 （示例：D:\Maven\apache-maven-3.8.8\bin）。

步骤 2：配置系统 Path 变量

电脑搜索框输入：编辑系统环境变量，打开「系统属性」-「环境变量」；
在下方系统变量 中找到 Path，双击打开；
点击「新建」，粘贴刚才复制的 bin 目录路径；
一路点击确定保存配置（不要直接关闭窗口）。

步骤 3：验证安装是否成功

搜索框打开 命令提示符（CMD）；
输入命令：mvn -v；
出现 Maven 版本号、Java 版本号信息 → 安装成功！

三、Maven 核心配置（本地仓库 + 阿里云镜像）

Maven 默认从国外服务器下载依赖，速度极慢，必须配置本地仓库 和阿里云镜像加速。

1. 创建本地仓库

在 D 盘根目录 新建文件夹，命名为 repository（纯英文，作为 Maven 依赖存放位置）；
完整路径：D:\repository。

2. 修改配置文件 settings.xml

打开 Maven 配置目录：D:\Maven\apache-maven-3.8.8\conf；
找到 settings.xml 文件，用记事本/代码编辑器打开。

配置 1：本地仓库路径

在 <settings> 标签内，添加以下代码，指定本地仓库位置：

xml 复制代码

<!-- 本地仓库路径：D盘的repository文件夹 -->
<localRepository>D:\repository</localRepository>

配置 2：阿里云镜像（加速下载）

找到 <mirrors> 标签，替换为以下阿里云镜像配置：

xml 复制代码

<mirrors>
    <!-- 阿里云Maven镜像，加速依赖下载 -->
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>central</mirrorOf>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>

保存并关闭 settings.xml 文件。

四、IDEA 集成本地 Maven

IDEA 默认自带 Maven，建议替换为自己配置的版本，统一环境。

配置步骤

打开 IDEA，点击顶部菜单：File → Settings（设置）；
展开：Build, Execution, Deployment → Build Tools → Maven；
修改 3 个核心配置（全部改为自己的路径）：
- Maven home path ：Maven 解压目录 D:\Maven\apache-maven-3.8.8；
- User settings file ：勾选 Override，选择 D:\Maven\apache-maven-3.8.8\conf\settings.xml；
- Local repository ：自动读取配置，显示 D:\repository 即可；
点击 Apply → OK 保存配置。

五、Maven 引入第三方依赖库（核心用法）

Maven 最大作用：无需手动下载 jar 包 ，直接在 pom.xml 配置即可自动下载管理。

1. 依赖查找方式

直接问 AI（如豆包）：输入「XXX 工具 Maven 依赖」；
官方仓库查询：Maven 中央仓库。

2. 依赖引入步骤

打开项目的 pom.xml 文件；
在 <project> 标签内，创建 <dependencies> 标签；
将查询到的依赖代码，粘贴到 <dependencies> 中；
IDEA 会自动刷新下载依赖（无自动刷新，点击 pom.xml 右上角刷新按钮）。

示例：引入 JSON 处理依赖（Jackson）

xml 复制代码

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <!-- 项目基本信息 -->
    <groupId>org.example</groupId>
    <artifactId>demo</artifactId>
    <version>1.0-SNAPSHOT</version>

    <!-- 项目配置：JDK版本、编码 -->
    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <!-- 第三方依赖配置区：所有需要的库都写在这里 -->
    <dependencies>
        <!-- JSON 处理工具：Jackson -->
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <version>2.15.2</version>
        </dependency>
    </dependencies>
</project>

六、完整流程总结

下载 Maven 压缩包 → D 盘解压；
配置 bin 目录到系统 Path → mvn -v 验证；
D 盘建 repository 仓库 → 修改 settings.xml 配置本地仓库+阿里云镜像；
IDEA 绑定自己的 Maven 配置；
查依赖 → 粘贴到 pom.xml → 自动下载使用。

总结

全程使用纯英文路径，避免中文/空格导致报错；
阿里云镜像必须配置，否则依赖下载极慢；
IDEA 配置 Maven 时，务必勾选 Override 手动指定配置文件；
依赖引入仅需修改 pom.xml，无需手动管理 jar 包，是 Java 开发必备工具。