2026-08-27 · 项目管理和构建工具——依赖管理、项目构建、统一结构。

Maven 快速上手

1. Maven 解决什么问题

不用 Maven 的痛点：

// 手动复制 jar 包到 lib 目录
// - 版本不一致（A 项目用 mysql-5.1，B 项目用 mysql-8.0）
// - jar 包冲突（两个 jar 有同名类）
// - 项目结构混乱（每个项目自己组织代码）
// - 构建麻烦（手动编译、打包、部署）

Maven 的解决方案：

问题	Maven 怎么解决
jar 包管理	在 pom.xml 里声明依赖，自动下载
版本冲突	统一版本号管理
项目结构	强制约定目录结构（src/main/java 等）
构建流程	一键 mvn clean package 打包

2. 下载与安装

下载

官网：https://maven.apache.org/download.cgi

解压到 C:\Java\maven（路径不含中文和空格）。

环境变量

MAVEN_HOME = C:\Java\maven
Path 追加 %MAVEN_HOME%\bin

验证

mvn -v
# 输出：Apache Maven 3.x.x，Java 25 等信息

推荐用 scoop 安装：scoop install maven，自动配好环境变量。

3. 仓库配置

Maven 从哪里下载 jar 包：

本地仓库（本机缓存）
  ↑ 没有就去
远程仓库（阿里云镜像）
  ↑ 没有就去
中央仓库（Maven 官方，国外，慢）

配置阿里云镜像（国内必配）

编辑 %MAVEN_HOME%\conf\settings.xml，在 <mirrors> 里加：

<mirror>
    <id>aliyun</id>
    <mirrorOf>central</mirrorOf>
    <name>Aliyun Maven</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

配置本地仓库路径

settings.xml 里加（可选，不配就用默认的 ~/.m2/repository）：

<localRepository>C:\Java\maven-repo</localRepository>

IDEA 里的 Maven 配置

File → Settings → Build, Execution, Deployment → Build Tools → Maven：

• Maven home path：C:\Java\maven（或 scoop 路径）
• User settings file：C:\Java\maven\conf\settings.xml
• Local repository：会自动识别

IDEA 自带 Maven 插件，但推荐用自己安装的 Maven 版本（版本可控）。

4. IDEA 创建 Maven 项目

方式一：直接创建

1. File → New → Project
2. 左侧选 Maven
3. 填 Project Name、Location
4. 勾选 Create from archetype（可选，选 maven-archetype-quickstart 生成基础结构）
5. 点 Create

方式二：Spring Boot 项目（更常用）

1. File → New → Project
2. 左侧选 Spring Initializr
3. 填写 Group、Artifact、Java Version
4. 选择依赖（Spring Web、MySQL Driver 等）
5. 点 Create

Spring Initializr 自动创建 pom.xml + 目录结构 + 入口类，是最常用的创建方式。

5. 项目结构

Maven 约定的标准目录：

my-project/
├── pom.xml                    ← 项目配置（核心文件）
├── src/
│   ├── main/
│   │   ├── java/              ← 源代码
│   │   │   └── com/example/
│   │   │       └── App.java
│   │   ├── resources/         ← 配置文件（application.yml 等）
│   │   └── webapp/            ← Web 资源（可选）
│   └── test/
│       ├── java/              ← 测试代码
│       └── resources/         ← 测试配置
└── target/                    ← 编译输出（自动生成）

不用自己建目录，IDEA 创建 Maven 项目时自动生成。

6. 导入依赖（pom.xml）

pom.xml 基本结构

<?xml version="1.0" encoding="UTF-8"?>
<project>
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>      <!-- 组织/公司 -->
    <artifactId>my-project</artifactId>  <!-- 项目名 -->
    <version>1.0-SNAPSHOT</version>      <!-- 版本号 -->

    <dependencies>
        <!-- MySQL 驱动 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.33</version>
        </dependency>

        <!-- JUnit 测试 -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13.2</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

怎么找依赖

1. 打开 https://mvnrepository.com/
2. 搜索（比如 "mysql connector"）
3. 选版本，复制 XML 代码
4. 粘贴到 pom.xml 的 <dependencies> 里
5. IDEA 右下角点 Load Maven Changes（刷新图标）

Maven 常用命令

mvn clean            # 清理 target 目录
mvn compile          # 编译源代码
mvn test             # 运行测试
mvn package          # 打包（jar 或 war）
mvn clean package    # 清理 + 打包（最常用）
mvn install          # 安装到本地仓库

IDEA 里不用记命令：右键项目 → Run Maven → 对应目标即可。

7. 常见坑

<!-- 坑1：版本号写错（找不到依赖） -->
<!-- ❌ -->
<version>8.0.3</version>  <!-- 应该是 8.0.33 -->

<!-- 坑2：依赖没有刷新（IDEA 不识别） -->
<!-- 改完 pom.xml 后，点右下角的刷新图标或 Ctrl+Shift+O -->

<!-- 坑3：下载慢/失败（没配阿里云镜像） -->
<!-- 回到第3步配镜像 -->

Maven 上手门槛主要在配置（镜像、仓库路径），用起来之后就是声明依赖 + 一键打包。