作者guangshi007

·2022-11-03 12:30

技术经理·某城商行IT人

关注270

Maven 最全教程，看了必懂，99% 的人都收藏了！

字数 12783阅读 610评论 0赞 1

https://mp.weixin.qq.com/s/Cfqz2Cepzjp2vm_njt6fzA

## **一、为什么使用Maven这样的构建工具【why】******

**① 一个项目就是一个工程**

如果项目非常庞大，就不适合使用package来划分模块，最好是每一个模块对应一个工程，利于分工协作。借助于maven就可以将一个项目拆分成多个工程

**② 项目中使用jar包，需要“复制”、“粘贴”项目的lib中**

同样的jar包重复的出现在不同的项目工程中，你需要做不停的复制粘贴的重复工作。借助于maven，可以将jar包保存在“仓库”中，不管在哪个项目只要使用引用即可就行。

**③ jar包需要的时候每次都要自己准备好或到官网下载**

借助于maven我们可以使用统一的规范方式下载jar包，规范

**④ jar包版本不一致的风险**

不同的项目在使用jar包的时候，有可能会导致各个项目的jar包版本不一致，导致未执行错误。借助于maven，所有的jar包都放在“仓库”中，所有的项目都使用仓库的一份jar包。

**⑤ 一个jar包依赖其他的jar包需要自己手动的加入到项目中**

FileUpload组件->IO组件，commons-fileupload-1.3.jar依赖于commons-io-2.0.1.jar ， 极大的浪费了我们导入包的时间成本，也极大的增加了学习成本。借助于maven，它会自动的将依赖的jar包导入进来。

## **二、maven是什么【what】******

**① maven是一款服务于java平台的自动化构建工具**

make->Ant->Maven->Gradle

名字叫法：我们可以叫妹文也可以叫麦文，但是没有叫妈文的。

**② 构建**

构建定义：把动态的Web工程经过编译得到的编译结果部署到服务器上的整个过程。

编译：java源文件[.java]->编译->Classz字节码文件[.class]

部署：最终在sevlet容器中部署的不是动态web工程，而是编译后的文件
 ![](/home/attachment/202211/03/374371_166744844778516.png) 
**③ 构建的各个环节**

-  · 清理clean：将以前编译得到的旧文件class字节码文件删除

-  · 编译compile：将java源程序编译成class字节码文件

-  · 测试test：自动测试，自动调用junit程序

-  · 报告report：测试程序执行的结果

-  · 打包package：动态Web工程打War包，java工程打jar包

-  · 安装install：Maven特定的概念-----将打包得到的文件复制到“仓库”中的指定位置

-  · 部署deploy：将动态Web工程生成的war包复制到Servlet容器下，使其可以运行

## 三、 **安装maven******

** 注意：**
安装的maven版本需要跟你的JDK及IDE开发软件**兼容**** ，我安装的JDK是 **bellsoft-jdk11.0.16.1** ，IDE开发环境装的是 **ideaIC-2022.2.3** ，开始装的Maven版本是**apache-maven-3.8.6-bin.zip**，结果有一大堆的问题，搞了几天都没调通环境，后面四处搜索才发现是maven-3.8.6跟ideaIC-2022.2.3版本兼容性有问题，只得又重新下了 **apache-maven-3.6.3-bin.zip** ，后面环境才调试通过，这个坑一定要避免。各版本的IDEA跟maven的兼容性参考这个链接： [https://blog.csdn.net/qq_44866828/article/details/117571120](https://blog.csdn.net/qq_44866828/article/details/117571120)

为保险起见， 建议Maven安装3.6.3版本 ，兼容性比较好。

① 当前系统是否配置JAVA_HOME的环境变量

② 下载maven，解压maven放在一个非中文无空格的路径下

③ 配置maven的相关环境变量

· 在环境变量增加M AVEN _HOME，路径是maven解压后的根目录

· 在环境变量里的path中增加$M AVEN _HOME/bin的目录

④  打开conf/setting.xml文件，修改本地仓库与远程仓库

修改本地仓库为D:\\apache-maven-3.6.3\\Repository，修改远程仓库为阿里云maven仓库（如**第55行**与**149--155行**所示）
![](/home/attachment/202211/03/374371_166744854033226.png)
![](/home/attachment/202211/03/374371_166744854120338.png)

⑤ 验证：mvn -v 查看maven版本
![](/home/attachment/202211/03/374371_166744857311821.png)

看到版本信息，恭喜你已经OK了。

## **四、第一个maven******

**① 创建约定的目录结构** （maven工程必须按照约定的目录结构创建）

我们按照 下 面的文件夹目录结构手动创建一下，不用任何IDE环境（手动的其实最有助于我们理解maven）
![](/home/attachment/202211/03/374371_166744868879732.png)

### **文件内容如下******
 在src/main/java/com/hzg/maven目录下新建文件Hello.java，内容如下 
 ![](/home/attachment/202211/03/374371_166744873371570.png)

```java
package com.hzg.maven;
public  class Hello {
	public String sayHello(String name){
		return "Hello "+name+"!";
	}
}
```

POM文件内容：
![](/home/attachment/202211/03/374371_166744895818839.png)
```java
<?xml version="1.0" ?>
<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>com.hzg.maven</groupId>
	<artifactId>Hello</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	
	<name>Hello</name>
	
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.Encoding>UTF-8</maven.compiler.Encoding>
		<java.version>11</java.version>
		<maven.compiler.source>11</maven.compiler.source>
		<maven.compiler.target>11</maven.compiler.target>		
	</properties>
	
	<dependencies>
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>4.0</version>
			<scope>test</scope>
		</dependency>
	</dependencies>
</project>
```

**② 常用maven命令****（****执行maven命令必须进入到pom.xml的目录中进行执行****）**

1.  · mvn clean：清理

1.  · mvn compile：编译主程序

1.  · mvn test-compile：编译测试程序

1.  · mvn test：执行测试

1.  · mvn package：打包

1.  · mvn install：安装
![](/home/attachment/202211/03/374371_166744951682749.png)

进入到项目的pom.xml目录之后，就可以执行啦。

1、 **运行mvn compile******

第一次执行时，出现字符编码的警告，还有如下报错：
![](/home/attachment/202211/03/374371_166744955231424.png)

又是网上一顿搜索，看到有人说是JDK的版本不对，字符编码未设置（默认为GBK），在pom.xml文件中指定字符编码及JDK版本（即pom.xml文件增加12--18行内容）。

更正完后继续执行 **mvn compile** ，编译成功。 编译过程中自动下载缺少的依赖，注意执行过程必须保证电脑连接到互联网，因为需要从阿里云下载所需要的jar包。
![](/home/attachment/202211/03/374371_166744963525479.png)

OK，运行完毕，你在pom.xml配置的依赖的包已经导入到仓库了 。

刚才执行完compile之后，之前的文件夹发生了变化
![](/home/attachment/202211/03/374371_166744967959074.png)

我们发现Hello项目里里多了一个target文件夹。文件夹的内容为：
![](/home/attachment/202211/03/374371_166744970438176.png)

发现target里主要存放的就是编译后的字节码文件 。

**2、运行mvn test-compile** ，target文件夹下面除了classes之外多了test-classes文件夹

**3、运行mvn package** ，target文件夹下面又多了一个打好的jar包
![](/home/attachment/202211/03/374371_166744975674655.png)

4、运行mvn clean，发现整个target文件夹都没了。又回到了编译之前我们手动创建的文件夹
![](/home/attachment/202211/03/374371_166744979215427.png)

## [**五、仓库和坐标**](file:///C:/Users/Administrator/Desktop/Maven%E5%AE%89%E8%A3%85%E9%85%8D%E7%BD%AE%E6%95%99%E7%A8%8B.doc#wechat_redirect)****

**① pom.xml：** Project Object Model 项目对象模型。它是maven的核心配置文件，所有的构建的配置都在这里设置。

**② 坐标：** 使用下面的三个向量在仓库中唯一的定位一个maven工程
![](/home/attachment/202211/04/374371_166753266285350.png)

**③ maven工程的坐标与仓库中路径的关系：**
![](/home/attachment/202211/04/374371_166753273881053.png)

maven坐标和仓库对应的映射关系：[groupId][artifactId][version] ---> [artifactId]-[version].jar

去本地仓库看一下此目录：org\\springframework\\spring-core\\4.3.4.RELEASE\\spring-core-4.3.4.RELEASE.jar果然是完全对应的 。

**④ 仓库**

仓库的分类：

**1、本地仓库：** 当前电脑上的仓库，路径上已经说过了哦

**2、远程仓库：**

· 私服：搭建在局域网中，一般公司都会有私服，私服一般使用nexus来搭建。具体搭建过程可以查询其他资料

· 中央仓库：架设在Internet上，像刚才的springframework就是在中央仓库上

## **六、依赖******

**① maven解析依赖信息时会到本地仓库中取查找被依赖的jar包**

· 对于本地仓库中没有的会去中央仓库去查找maven坐标来获取jar包，获取到jar之后会下载到本地仓库

· 对于中央仓库也找不到依赖的jar包的时候，就会编译失败了

**② 如果依赖的是自己或者团队开发的maven工程，需要先使用install命令把被依赖的maven工程的jar包导入到本地仓库中**

举例：现在我再创建第二个maven工程HelloFriend，其中用到了第一个Hello工程里类的sayHello(String name)方法。我们在给HelloFriend项目使用 mvn compile命令进行编译的时候，会提示缺少依赖Hello的jar包。怎么办呢？

到第一个maven工程中执行 mvn install后，你再去看一下本地仓库，你会发现有了Hello项目的jar包。一旦本地仓库有了依赖的maven工程的jar包后，你再到HelloFriend项目中使用 mvn compile命令的时候，可以成功编译

**③ 依赖范围**
![](/home/attachment/202211/04/374371_166753277955111.png)

_scope就是依赖的范围_

**1、compile，** 默认值，适用于所有阶段（开发、测试、部署、运行），本jar会一直存在所有阶段。

**2、provided，** 只在开发、测试阶段使用，目的是不让Servlet容器和你本地仓库的jar包冲突 。如servlet.jar。

**3、runtime，** 只在运行时使用，如JDBC驱动，适用运行和测试阶段。

**4、test，** 只在测试时使用，用于编译和运行测试代码。不会随项目发布。

**5、system，** 类似provided，需要显式提供包含依赖的jar，Maven不会在Repository中查找它。

## **七、生命周期******

Maven有三套相互独立的生命周期，请注意这里说的是“三套”，而且“相互独立”，初学者容易将Maven的生命周期看成一个整体，其实不然。这三套生命周期分别是：

**① Clean Lifecycle 在进行真正的构建之前进行一些清理工作。** Clean生命周期一共包含了三个阶段：

· pre-clean 执行一些需要在clean之前完成的工作

· clean 移除所有上一次构建生成的文件

· post-clean 执行一些需要在clean之后立刻完成的工作

**② Default Lifecycle 构建的核心部分，编译，测试，打包，部署等等。**

· validate 合法性检查

· generate-sources

· process-sources

· generate-resources

· process-resources 复制并处理资源文件，至目标目录，准备打包

· compile 编译项目的源代码

· process-classes

· generate-test-sources

· process-test-sources

· generate-test-resources

· process-test-resources 复制并处理资源文件，至目标测试目录

· test-compile 编译测试源代码

· process-test-classes

· test 使用合适的单元测试框架运行测试。这些测试代码不会被打包或部署

· prepare-package

· package 接受编译好的代码，打包成可发布的格式，如 JAR /WAR

· pre-integration-test

· integration-test

· post-integration-test

· V erify 校验

· install 将包安装至本地仓库，以让其它项目依赖。

· deploy 将最终的包复制到远程的仓库，以让其它开发人员与项目共享

那我们在Hello的项目中执行 mvn install 命令，通过日志看看中间经历了什么？
![](/home/attachment/202211/04/374371_166753284011976.png)

通过日志我们发现，其实执行mvn install，其中已经执行了compile 和 test 。

**总结：** 不论你要执行生命周期的哪一个阶段，maven都是从这个生命周期的开始执行

**插件：** 每个阶段都有插件（plugin），看上面标红的。插件的职责就是执行它对应的命令。

**③ Site Lifecycle 生成项目报告，站点，发布站点。**

· pre-site 执行一些需要在生成站点文档之前完成的工作

· site 生成项目的站点文档

· post-site 执行一些需要在生成站点文档之后完成的工作，并且为部署做准备

· site-deploy 将生成的站点文档部署到特定的服务器上

## **八、Eclipse中使用maven******

**①、配置**

选择菜单windows-->preferences（参数）-->maven

选择Installations（安装），添加你自己下载并解压好的maven目录。并打上对勾 √，点击Apply（应用）
![](/home/attachment/202211/04/374371_166753290745801.png)

再选择User Settings目录，在User Settings中选择Browse（浏览），选择你自己maven里的conf下的settings.xml文件。
![](/home/attachment/202211/04/374371_166753292759055.png)

插一句：settings.xml这个配置文件，主要是配置你本地仓库的路径的。不想使用默认路径，就打开文件，加上自己的路径配置。

C:\\Program Files\\Java\\repository

到此，maven整个的设置就OK了。

**② 使用Eclipse创建maven的Web工程**

1、选择菜单File-->new -->project，输入maven
![](/home/attachment/202211/04/374371_166753299410572.png)

选择Maven Project，点击Next
![](/home/attachment/202211/04/374371_166753303399707.png)

点击Next
![](/home/attachment/202211/04/374371_166753305344579.png)

输入webapp，选中第一项，点击next
![](/home/attachment/202211/04/374371_166753307255102.png)

项目就创建完成了，但是jdk的版本还有sevlet-api等jar包还没有
![](/home/attachment/202211/04/374371_166753317297493.png)

选择创建好的工程单击右键，选择properties 并找 到 Project Facets ， Dynnamic Web Module 版本选择3.1，下面的java版本选择1.8，点击Apply
![](/home/attachment/202211/04/374371_166753330917350.png)

选择创建好的工程单击右键，找到 Java build path ， 单击 Libaries，添加Tomcat8.5的依赖库，点击OK 完成。
![](/home/attachment/202211/04/374371_166753346083736.png)

![](/home/attachment/202211/04/374371_166753336076256.png)

## **九、maven工程的依赖高级特性******

**① 依赖的传递性**
![](/home/attachment/202211/04/374371_166753367651856.png)

WebMavenDemo项目依赖JavaMavenService1 ， JavaMavenService1项目依赖JavaMavenService2

pom.xml文件配置好依赖关系后，必须首先mvn install后，依赖的jar包才能使用。

-  · WebMavenDemo的pom.xml想能编译通过，JavaMavenService1必须mvn install

-  · JavaMavenService 1 的pom.xml想能编译通过，JavaMavenService2必须mvn install

**传递性：**
![](/home/attachment/202211/04/374371_166753377674162.png)

在Eclipse中，为JavaMavenService2中增加了一个spring-core.jar包后，会惊喜的发现依赖的两个项目都自动的增加了这个jar包，这就是依赖的传递性。
 注意：非compile范围的依赖是不能传递的。

**② 依赖版本的原则：**

**1、路径最短者优先原则**
![](/home/attachment/202211/04/374371_166753383737877.png)
 Service2的log4j的版本是1.2.7版本，Service1排除了此包的依赖，自己加了一个Log4j的1.2.9的版本，那么WebMavenDemo项目遵守路径最短优先原则，Log4j的版本和Sercive1的版本一致。

**2、路径相同先声明优先原则**

这种场景依赖关系发生了变化，WebMavenDemo项目依赖Sercive1和Service2，它俩是同一个路径，那么谁在WebMavenDemo的pom.xml中先声明的依赖就用谁的版本。
![](/home/attachment/202211/04/374371_166753388533994.png)

**③ 统一管理依赖的版本：******

为了统一管理版本号，可以使用properties标签，里面可以自定义版本的标签名。在使用的地方使用${自定义标签名}
![](/home/attachment/202211/04/374371_166753393748464.png)

****

## **十、build配置******
![](/home/attachment/202211/04/374371_166753400586884.png)![](/home/attachment/202211/04/374371_166753400582529.png)
```java
<build>
  
  <finalName>WebMavenDemo</finalName>
  
  <resources>
    
    <resource>
      
      <directory>src/main/java</directory>
      
      <includes>
        <include>**/*.xml</include>
      </includes>
      
      <excludes>
        <exclude>**/*.txt</exclude>
          <exclude>**/*.doc</exclude>
      </excludes>
    </resource>
  </resources>
  
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>2.1</version>
      <configuration>
        
        <source>1.8</source>
        
        <target>1.8</target>
      </configuration>
    </plugin>
    
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-resources-plugin</artifactId>
      <version>2.1</version>
      <executions>
        <execution>
          <phase>compile</phase>
        </execution>
      </executions>
      <configuration>
        <encoding>UTF-8</encoding>
      </configuration>
    </plugin>
    
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-war-plugin</artifactId>
      <version>2.1</version>
      <configuration>
        
        <warName>WebMavenDemo1</warName>
      </configuration>
    </plugin>
  </plugins>
</build>
```
 配置好build后，执行mvn package之后，在maven工程指定的target目录里war包和文件都按照配置的生成了
![](/home/attachment/202211/04/374371_166753408926204.png)

好了，maven的所有的内容就整理完了。

最后推荐个最新最全的maven依赖项版本查询网站：

http://mvnrepository.com/

maven

著作权归作者所有

如果觉得我的文章对您有用，请点赞。您的支持将鼓励我继续创作！

添加新评论0 条评论

Ctrl+Enter 发表

匿名评论

Maven 最全教程，看了必懂，99% 的人都收藏了！

添加新评论0 条评论

作者其他文章

相关文章

相关资料