← 课程目录 🚀 从零到一
📐 学习维度 阶段1 · 第1章 环境与工具 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

1.2 Maven:为什么你的项目下载了一堆 jar

审校 2026-09-26 · 素材来源:Maven实战、乐字节课程资料
📑 本篇章节导航 (共10节,点击直达)
没有 Maven 的世界Maven 是什么最小示例:声明一个依赖它背后做了什么传递依赖与版本冲突:一个具体例子pom.xml 还管什么生命周期:一键构建到底按了什么下载慢?配国内镜像踩坑清单一句话总结

你兴冲冲导入了第一个 Spring Boot 项目,右下角开始疯狂下载几百个 jar 包,进度条转了好几分钟。别慌,这不是电脑中毒,是 Maven 在干活。这篇讲清它下载了什么、为什么要下载。

没有 Maven 的世界

写个功能要用别人写好的库(比如操作 Excel 的工具类),这些库就是一个个 jar(Java Archive,Java 的压缩包格式,里面装的是编译好的代码)。

没有 Maven 时你得手动做:去官网下载 jar → 放进项目 → 右键加入依赖。你的库又依赖别的库,一层套一层,下错版本就报 ClassNotFoundException。这就是传说中的「Jar 地狱」。

地狱有多深?举个真实的账:一个 Spring MVC + MyBatis 的老项目,手动管 jar 要三十多个,还得版本配套。某个库升级 0.1,另外三个跟着要换,漏一个就是线上启动失败。2010 年前的 Java 程序员每天都在做这种拼图,直到构建工具把这活接管了。

Maven 是什么

Maven(读作「梅文」)是 Java 项目的管家,干两件事:

1. 管依赖:你只要在清单里写「我要用什么」,它自动下载全部连带依赖

2. 管构建:一键完成清理、编译、测试、打包

一个买菜类比:

最小示例:声明一个依赖

新建 Maven 项目(IDEA 里 New Project → 构建系统选 Maven),打开根目录的 pom.xml,在 <dependencies> 里加一段:


<dependency>
    <groupId>org.junit.jupiter</groupId>      <!-- 作者 namespace -->
    <artifactId>junit-jupiter</artifactId>     <!-- 库名 -->
    <version>5.10.0</version>                  <!-- 版本号 -->
    <scope>test</scope>                        <!-- 只在测试时用 -->
</dependency>

保存后右下角自动导入,本地仓库里就多了 junit 目录。三个坐标(groupId + artifactId + version)唯一定位一个 jar,像「省+市+门牌号」。

打开本地仓库逛一圈,你会发现目录结构和坐标严格对应:org/junit/jupiter/junit-jupiter/5.10.0/。所以坐标不只是「名字」,也是冰箱里的货架编号——传坐标等于直接定位到货架,快且不会拿错。

它背后做了什么

点一下刷新,Maven 跑了这五步:

1. 读 pom.xml,拿到你要的直接依赖

2. 解析每个依赖自己的 pom,挖出传递依赖(依赖的依赖,树状展开)

3. 检查本地仓库有没有,没有就去中央仓库下载

4. 版本冲突时按「最短路径优先」选一个(可用 <exclusion> 手动剔除)

5. 把整棵依赖树挂到项目 classpath 上,编译就能 import 了

scope 常用三个:compile 全程可用(默认)、test 只测试时可用、provided 编译要但运行时环境自带。

classpath(类路径,JVM 找类的搜索清单)是这出戏的主角:你 import 的每个类,JVM 都挨个翻 classpath 里的 jar 找。所谓「加依赖」,本质是往这份清单里添货架。以后报 ClassNotFoundException,第一反应就是「哪个 jar 没进 classpath」。

传递依赖与版本冲突:一个具体例子

假设你引了 A 和 B 两个库:A 要 jackson 2.15,B 要 jackson 2.17。两棵子树在 jackson 这里撞车,Maven 按「最短路径优先」挑一个——离你近的赢。被淘汰的版本就消失了吗?不一定:如果 B 真的用了 2.17 才有的方法,运行时就炸 NoSuchMethodError。

排查三步走:

1. mvn dependency:tree -Dincludes=com.fasterxml.jackson.core 把 jackson 的来龙去脉打出来

2. 看清楚是谁带进来的旧版本

3. 在引入旧版的依赖里加 <exclusions> 剔掉它,或用 <dependencyManagement> 统一锁版本

Spring Boot 项目为什么很少遇到这种事?因为 parent(下面讲)已经把几百个常用库的版本测好、锁死了,这套版本表就是面试常说的 BOM(Bill of Materials,物料清单)。你自己引时不写 version,直接继承它的裁决。

pom.xml 还管什么

依赖之外,pom 还是项目的户口本,扫一眼骨架:

约定优于配置是 Maven 的世界观:源码在 src/main/java、测试在 src/test/java、资源在 src/main/resources——你不配置,它就按这套约定找。反着来当然可以配,但没人跟自己过不去。第一次见到「这目录结构怎么所有人长得都一样」,答案就在这。

生命周期:一键构建到底按了什么

命令行里 mvn clean package 是以后部署时的口头禅。Maven 把构建过程拆成三段生命周期(按顺序执行的阶段序列):

关键规则是执行后面的阶段会先把前面跑完:你敲 mvn install,它会依次 compile、test、package、install,一条龙。所以「测试挂了就打不出包」不是 bug 是设计——质量卡在流程里。

常用组合就两组:平时验证用 mvn clean compile,交付部署用 mvn clean package。看到 BUILD SUCCESS 才算数,红色的 BUILD FAILURE 上面几行必有原因。

顺带认识 target 目录:编译产物、测试报告、打出的 jar 全在这。它是「可以随时删掉重来」的目录——构建出问题,先 mvn clean 再说,一多半的玄学到此为止。

下载慢?配国内镜像

中央仓库在国外,第一次下载动辄几分钟。在 ~/.m2/settings.xml(没有就新建)里配镜像:


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

同一个超市,换了个近的门面,速度立刻起飞。

mirrorOf 填 central 只镜像中央仓库;填 * 是全接管。公司里通常还会给你一个私服地址(Nexus),原理一样:把「国外超市」换成「楼下仓库」,顺便存公司内部的包。

踩坑清单

一句话总结

Maven 用一份 pom 清单自动管下载和构建;理解「中央仓库→本地冰箱→classpath」这条链,再记住 dependency:tree 这把查冲突的手术刀,右下角的进度条就再也不会吓到你。