Maven 详细教程（万字长文）

不念不忘少年蓝@ 2024-03-30 16:47 95阅读 0赞

#### 目录 ####

*   *  一、Maven的简介
     *  二、Maven安装与配置
     *  三、Maven POM
     *  四、创建 Maven 项目
     *  五、Maven项目的构建与测试
     *  六、Maven依赖
     *  七、Maven仓库（本地仓库+远程仓库）
     *  八、Maven生命周期（clean+site+default）
     *  九、Maven常用插件
     *  十、Maven 版本号约定
     *  十一、Maven SNAPSHOT(快照)
     *  十二、Maven继承
     *  十三、profiles多环境配置
     *  十四、使用maven引入第三方jar包以及打包
     *  十五、关于微服务项目打包
     *  十六、Maven内置属性

### 一、Maven的简介 ###

**诞生：** Maven的创始人是`Jason Van Zyl`，诞生时间大概在`2001`年3月。Maven起源于Jakarta Alexandria项目，在2002年10月份左右Maven迁移到Turbine项目中继续发展。

**简介：** Maven 是一款`基于Java平台`的项目管理和整合工具，它将项目的开发和管理过程抽象成一个`项目对象模型（Project Object Model 简称 POM）`。开发人员只需要做一些简单的配置，Maven 就可以自动完成项目的编译、测试、打包、发布以及部署等工作。

**底层：** `Maven 是使用 Java 语言编写的，并且依赖于Java运行环境（ JDK 7.0 及以上），因此它和 Java 一样具有跨平台性`，这意味着无论是在 Windows ，还是在 Linux 或者 Mac OS 上，都可以使用相同的命令进行操作。

**Maven的核心功能便是通过xml标签的形式来合理叙述项目间的依赖关系，通俗点理解，把一个真实存在的一个jar包以xml的形式表示了出来，xml当中坐标就代表的是真实的jar，我们需要哪个jar直接引入其坐标，然后maven通过xml的坐标帮助我们下载对应的jar包。当我们不使用maven的时候就不能开发项目了吗？**

> 答：可以照常开发，并且能实现和Maven一模一样的功能，Maven他只是帮我们提供了一些便捷，来帮助我们简化开发。并不是直接用来辅助编码的，他的战斗岗位并不是我们所谓的控制层呀，表现层。

**不使用Maven带来的困扰：**

1.  `项目臃肿`：每个项目可能使用到的Jar包都是固定的，但是迫于无奈，只能将Jar包拷贝到各个项目当中，而且还需要将jar包上传到git / svn。使用maven以后只需要存储jar包的坐标即可。
2.  `Jar互相引用`：有些公司会封装一些自己的Jar，假如我们要改这个Jar包，我们还需要手动打包，再次将项目当中引用的Jar包给替换掉，使用Maven后，一个命令即可解决。
3.  `Jar包依赖关系`：使用一个框架Jar包他可能出现多层依赖关系，有时候为了解决依赖冲突，必须要去了解他们之间的关系，了解关系相对来说是非常麻烦的，必要的时候还需要通过反编译，而使用Maven之后，直接可以生成依赖关系图。
4.  `手动找Jar相当耗时`：我们Java项目所有的框架都是以Jar包的形式来发布，我们想要使用哪个框架就需要将Jar引入到我们的项目WEB-INF/lib当中，这样项目便可以使用该框架的类，Java框架官网普遍都是英文，想找一个自己想要的Jar包有时候是非常困难的，有时候着急要用就是找不到，网上会有人钻空子，让你付费下载，本身公司上班攒个钱就不容易，这家伙倒好，上个班还得倒贴。

> 使用 Maven 后每个 Jar 包只在本地仓库中保存一份，需要 Jar 包的工程只需要以坐标的方式简单的引用一下就可以了。然后打包的时候通过Maven打包插件会将项目所依赖的Jar全部打包进去。不仅极大的节约了存储空间，让项目更轻巧，更避免了重复文件太多而造成的混乱。将Maven的目标总结成一句话： `打造一个可重复使用，可维护且易于理解的项目综合模型，同时还提供了各种与此模型进行交互的工具和插件`

**约定优于配置**

> 约定优于配置（Convention Over Configuration）是 Maven 最核心的涉及理念之一 ，`Maven对项目的目录结构、测试用例命名方式等内容都做了规定，凡是使用 Maven 管理的项目都必须遵守这些规则`。

使用Maven之后项目结构都是由Maven约定好的，`开发人员必须遵循其约定`，结构如下：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70][]

> 针对于这一点可能较晚接触Java的，会误以为是Java项目的目录结构规范，其实不是的哈，这是Maven项目的目录结构规范！

**Maven 具有以下特点（`注：大概过一遍即可，后面每个细节都会讲到！`）：**

*  设置简单。
 *  所有项目的用法一致。
 *  可以管理和自动进行更新依赖。
 *  庞大且不断增长的资源库。
 *  可扩展，使用 Java 或脚本语言可以轻松的编写插件。
 *  几乎无需额外配置，即可立即访问新功能。
 *  基于模型的构建：Maven 能够将任意数量的项目构建为预定义的输出类型，例如 JAR，WAR。
 *  项目信息采取集中式的元数据管理：使用与构建过程相同的元数据，Maven 能够生成一个网站（site）和一个包含完整文档的 PDF。
 *  发布管理和发行发布：Maven 可以与源代码控制系统（例如 Git、SVN）集成并管理项目的发布。
 *  向后兼容性：您可以轻松地将项目从旧版本的 Maven 移植到更高版本的 Maven 中。
 *  并行构建：它能够分析项目依赖关系，并行构建工作，使用此功能，可以将性能提高 20%-50％。
 *  更好的错误和完整性报告：Maven 使用了较为完善的错误报告机制，它提供了指向 Maven Wiki 页面的链接，您将在其中获得有关错误的完整描述。

**Maven 的缺点：**

*  Maven 的整个体系相对庞大，想要完全掌握相对困难；
 *  如果项目的依赖过多，在第一次导入项目的时候需要花很长的时间来加载所需要的依赖；
 *  由于某种不可抗拒力，国内的开发者在使用 Maven 中央仓库的时候，下载速度过慢。

### 二、Maven安装与配置 ###

[https://blog.csdn.net/weixin\_43888891/article/details/128623086][https_blog.csdn.net_weixin_43888891_article_details_128623086]

### 三、Maven POM ###

POM（Project Object Model，项目对象模型）是 Maven 的基本组件，它是以 xml 文件的形式存放在项目的根目录下，名称为 `pom.xml`。`POM 中定义了项目的基本信息`，用于`描述项目如何构建、声明项目依赖`等等。

当 Maven 执行一个任务时，它会先查找当前项目的 POM 文件，读取所需的配置信息，然后执行任务。在 POM 中可以设置如下配置：

*  项目依赖
 *  插件
 *  目标
 *  构建时的配置文件
 *  版本
 *  开发者
 *  邮件列表

<parent> 
         
         <artifactId/> 
         
         <groupId/> 
         
         <version/> 
         
         <relativePath/> 
     </parent> 
         
        <modelVersion>4.0.0</modelVersion>  
          
        <groupId>asia.banseon</groupId>   
          
        <artifactId>banseon-maven2</artifactId>   
          
        <packaging>jar</packaging>   
          
        <version>1.0-SNAPSHOT</version>  
          
        <name>banseon-maven</name>  
          
        <url>http://www.baidu.com/banseon</url>  
          
        <description>A maven project to study maven.</description>   
        
     <prerequisites> 
      
        <maven/>
     </prerequisites> 
       
       <issueManagement> 
           
            <system>jira</system>  
            
            <url>http://jira.baidu.com/banseon</url>  
       </issueManagement>  
        
     <ciManagement> 
      　　
     　　 <system/> 
      　　
      　　<url/> 
       
      　　<notifiers> 
      　　　　 
      　　　　 <notifier> 
       　　　　 
       　　　　　　 <type/> 
       　　　　　　 
       　　　　　　 <sendOnError/> 
       　　　　　　　　 
        　　　　　　<sendOnFailure/> 
       　　　　　　 
       　　　　　　 <sendOnSuccess/> 
        　　　　　　
      　　　　　　  <sendOnWarning/> 
       　　　　　　 
       　　　　　　 <address/> 
       　　　　　　 
       　　　　　　 <configuration/>
      　　　　 </notifier>
      　　</notifiers>
     </ciManagement> 
     
        <inceptionYear/> 
          
        <mailingLists> 
           
            <mailingList>  
             
                <name>Demo</name>   
                  
                <post>gxs@126.com</post>  
                  
                <subscribe>gxs@126.com</subscribe>   
                  
                <unsubscribe>gxs@126.com</unsubscribe>  
                
                <archive>http:/hi.baidu.com/banseon/demo/dev/</archive>  
            </mailingList>  
        </mailingLists>  
          
        <developers>       
            <developer>  
             
                <id>HELLO WORLD</id>   
                
                <name>gxs</name>  
                
                <email>gxs@126.com</email>  
                
                <url/> 
                
                <roles>  
                    <role>Project Manager</role>  
                    <role>Architect</role>  
                </roles> 
                 
                <organization>demo</organization>  
                
                <organizationUrl>http://hi.baidu.com/banseon</organizationUrl>  
                
                <properties>  
                    <dept>No</dept>  
                </properties> 
                 
                <timezone>-5</timezone>  
            </developer>  
        </developers>  
          
        <contributors> 
         
        　　 <contributor>
            　　　<name/>　　　　　　　　<email/>　　　　　　　　<url/>　　　　　　　　<organization/>　　　　　　　　<organizationUrl/>　　　　　　　　<roles/>　　　　　　　　<timezone/>　　　　　　　　<properties/>
        　　 </contributor>     
        </contributors>    
          
        <licenses> 
           
            <license> 
              
                <name>Apache 2</name>  
                
                <url>http://www.baidu.com/banseon/LICENSE-2.0.txt</url>  
                
                <distribution>repo</distribution>  
                
                <comments>A business-friendly OSS license</comments>  
            </license>  
        </licenses>  
        
        <scm>  
             
            <connection>  
             scm:svn:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk)
            </connection>  
            
            <developerConnection>  
                scm:svn:http://svn.baidu.com/banseon/maven/banseon/dao-trunk   
            </developerConnection> 
            
            <tag/>         
              
            <url>http://svn.baidu.com/banseon</url>  
        </scm>  
          
        <organization>  
         
            <name>demo</name>   
            
            <url>http://www.baidu.com/banseon</url>  
        </organization> 
        
        <build> 
        　　　　
      　　　　<sourceDirectory/> 
      　　　　
      　　　　<scriptSourceDirectory/> 
      　　　　
     　　　　 <testSourceDirectory/> 
     　　　　 
     　　　　 <outputDirectory/> 
      　　　　
      　　　　<testOutputDirectory/> 
     　　　　 
     　　　　 <extensions> 
       　　　　　　
       　　　　　　<extension> 
        　　　　　　　　
        　　　　　　　　<groupId/> 
        　　　　　　　　
       　　　　　　　　 <artifactId/> 
        　　　　　　　　
       　　　　　　 <version/>
       　　　　　　</extension>
      　　　　</extensions> 
      　　　　
     　　　　 <defaultGoal/> 
      　　　　
     　　　　 <resources> 
       　　　　　　
       　　　　　　<resource> 
        　　　　　　
        　　　　　　<targetPath/> 
       　　　　　　 
        　　　　　　<filtering/> 
        　　　　　　
       　　　　　　 <directory/> 
        　　　　　　
        　　　　　　<excludes/>
       　　　　　</resource>
      　　　 </resources> 
      　　　　
     　　　　 <testResources> 
      　　　　 
      　　　　　　 <testResource>
        　　　　　　　　<targetPath/>　　　　　　　　　　<filtering/>　　　　　　　　　　<directory/>　　　　　　　　　　<includes/>　　　　　　　　　　<excludes/>
     　　　　　　  </testResource>
     　　　　 </testResources> 
      　　　　
      　　　　<directory/> 
      　　　　
      　　　　<finalName/> 
     　　　　 
     　　　　 <filters/> 
     　　　　 
     　　　　 <pluginManagement> 
       　　　　
      　　　　　　 <plugins> 
       　　　　　　　　 
        　　　　　　　　<plugin> 
        　　　　　　　　　　 
        　　　　　　　　　　 <groupId/> 
         　　　　　　　　　　
         　　　　　　　　　　<artifactId/> 
        　　　　　　　　　　 
         　　　　　　　　　　<version/> 
         　　　　　　　　　　
         　　　　　　　　　　<extensions/> 
         　　　　　　　　　　
         　　　　　　　　　　<executions> 
          　　　　　　　　　　　　
          　　　　　　　　　　　　<execution> 
           　　　　　　　　　　　　
           　　　　　　　　　　　　<id/> 
          　　　　　　　　　　　　
          　　　　　　　　　　　　 <phase/> 
          　　　　　　　　　　　　 
           　　　　　　　　　　　　<goals/> 
           　　　　　　　　　　　　
           　　　　　　　　　　　　<inherited/> 
          　　　　　　　　　　　　 
          　　　　　　　　　　　　 <configuration/>
          　　　　　　　　　　　　　</execution>
        　　　　　　　　　　 </executions> 
        　　　　　　　　 
         　　　　　　　　<dependencies> 
         　　　　　　　　 
         　　　　　　　　　　 <dependency>
          　　　　　　　　　　　　......
          　　　　　　　　　　</dependency>
         　　　　　　　　</dependencies>      
         　　　　　　　　
         　　　　　　　　<inherited/> 
        　　　　　　　　 
        　　　　 <configuration/>
        　　</plugin>
       </plugins>
      </pluginManagement> 
      
      <plugins> 
       
       <plugin>
        　　<groupId/>　　　　 <artifactId/>　　　　 <version/>　　　　 <extensions/>
        　　　　<executions>
        　　　　　　 <execution>
          　　　　　　　　<id/>　　　　　　　　　　　　<phase/>　　　　　　　　　　　　<goals/>　　　　　　　　　　　　<inherited/>　　　　　　　　　　　　<configuration/>
         　　　　　　</execution>
        　　　　 </executions>
        　 　<dependencies> 
        　　　　 
        　　　　 <dependency>
          　　　　　　......
        　　　　 </dependency>
        　 　</dependencies>
        　　 <goals/>　　　　 <inherited/>　　　 　<configuration/>
      　　</plugin>
      </plugins>
    </build> 
     
     <profiles> 
      
      <profile> 
       
       <id/> 
      
      <activation> 
        　　
      　　<activeByDefault/> 
        
       　　 <jdk/> 
        
       　　 <os> 
         　　　　
         　　　　<name>Windows XP</name> 
        　　　　 
        　　　　 <family>Windows</family> 
       　　 　　 
       　　 　　 <arch>x86</arch> 
       　　  　　
       　　  　　<version>5.1.2600</version>
        　　</os> 
        
       　　 <property> 
        　　　　 
       　　 　　 <name>mavenVersion</name> 
        　　　　 
        　　　　 <value>2.0.3</value>
       　　 </property> 
        
       　　 <file> 
         　　　　
        　　 　　<exists>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</exists> 
        　　 
         　　<missing>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/　　　　　</missing>
       　　 </file>
       </activation> 
       
       <build>
        　　<defaultGoal/>
       　　 <resources>
       　　　　  <resource>
          　　　　　　<targetPath/><filtering/><directory/><includes/><excludes/>
         　　　　</resource>
        　　</resources>
        　　<testResources>
       　　　　  <testResource>
          　　　　　　<targetPath/><filtering/><directory/><includes/><excludes/>
         　　　　</testResource>
        　　</testResources>
       　　 <directory/><finalName/><filters/>
      　　  <pluginManagement>
        　　　　 <plugins> 
          　　　　
         　　　　　　 <plugin>
          　　　　　　　　 <groupId/><artifactId/><version/><extensions/>
           　　　　　　　　<executions>
            　　　　　　　　　　<execution>
            　　　　　　　　　　 <id/><phase/><goals/><inherited/><configuration/>
           　　　　　　　　　　 </execution>
           　　　　　　　　</executions>
          　　 　　　　　　<dependencies> 
            　　　　　　　　
            　　　　　　　　<dependency>
            　　　　　　　　 ......
            　　　　　　　　</dependency>
           　　　　　　　　</dependencies>
           　　　　　　　　<goals/><inherited/><configuration/>
          　　　　</plugin>
         　　</plugins>
        </pluginManagement>
        <plugins> 
         
        　　 <plugin>
         　　　　 <groupId/><artifactId/><version/><extensions/>
          　　　　<executions>
          　　　　　　 <execution>
          　　　　　　　　  <id/><phase/><goals/><inherited/><configuration/>
           　　　　　　</execution>
         　　　　 </executions>
          　　　　<dependencies> 
          　　　　 
          　　　　　　 <dependency>
          　　　　　　  ......
          　　　　　　</dependency>
         　　　　 </dependencies>
         　　　　 <goals/><inherited/><configuration/>
        　　 </plugin>
        </plugins>
     </build> 
       
       <modules/> 
       
       <repositories> 
        
        <repository>
         <releases>
          <enabled/><updatePolicy/><checksumPolicy/>
         </releases>
         <snapshots>
          <enabled/><updatePolicy/><checksumPolicy/>
         </snapshots>
         <id/><name/><url/><layout/>
        </repository>
       </repositories> 
       
       <pluginRepositories> 
            
        <pluginRepository>
         <releases>
          <enabled/><updatePolicy/><checksumPolicy/>
         </releases>
         <snapshots>
          <enabled/><updatePolicy/><checksumPolicy/>
         </snapshots>
         <id/><name/><url/><layout/>
        </pluginRepository>
       </pluginRepositories> 
       
       <dependencies> 
        
        <dependency>
         ......
        </dependency>
       </dependencies> 
       
       <reports/>    
       
       <reporting>
        ......
       </reporting> 
       
       <dependencyManagement>
        <dependencies> 
         
         <dependency>
          ......
         </dependency>
        </dependencies>
       </dependencyManagement> 
       
       <distributionManagement>
        ......
       </distributionManagement> 
       
       <properties/>
      </profile>
     </profiles> 
     
     <modules/>
          
        <repositories>  
         
            <repository> 
             
             <releases> 
              
        <enabled/> 
        
        <updatePolicy/> 
        
        <checksumPolicy/>
       </releases> 
       
       <snapshots>
        <enabled/><updatePolicy/><checksumPolicy/>
       </snapshots> 
       
       <id>banseon-repository-proxy</id>  
       
                <name>banseon-repository-proxy</name>  
                
                <url>http://192.168.1.169:9999/repository/</url>  
                
                <layout>default</layout>            
            </repository>  
        </repositories> 
        
        <pluginRepositories> 
         
      <pluginRepository>
       ......
      </pluginRepository>
     </pluginRepositories> 
        
          
        <dependencies>  
            <dependency>
       
                <groupId>org.apache.maven</groupId>  
                
                <artifactId>maven-artifact</artifactId>  
                
                <version>3.8.1</version>  
                
                <type>jar</type> 
                
                <classifier></classifier> 
                  
                <scope>test</scope>     
                 
                <systemPath></systemPath>  
                 
                <exclusions>
                 <exclusion>  
                        <artifactId>spring-core</artifactId>  
                        <groupId>org.springframework</groupId>  
                    </exclusion>  
                </exclusions>    
                  
                <optional>true</optional>
            </dependency>
        </dependencies> 
        
        <reports></reports> 
         
     <reporting> 
      
      <excludeDefaults/> 
      
      <outputDirectory/> 
      
      <plugins> 
       
       <plugin> 
        
        <groupId/> 
        
        <artifactId/> 
        
        <version/> 
        
        <inherited/> 
        
        <configuration/> 
        
        <reportSets> 
         
         <reportSet> 
          
          <id/> 
          
          <configuration/> 
          
          <inherited/> 
          
          <reports/>
         </reportSet>
        </reportSets>
       </plugin>
      </plugins>
     </reporting> 
      
     <dependencyManagement>
      <dependencies> 
       
       <dependency>
        ......
       </dependency>
      </dependencies>
     </dependencyManagement>     
          
        <distributionManagement> 
            
            <repository> 
             
       <uniqueVersion/>
       <id>banseon-maven2</id>  
       <name>banseon maven2</name>  
                <url>file://${basedir}/target/deploy</url>  
                <layout/>
      </repository> 
        
      <snapshotRepository>
       <uniqueVersion/>
       <id>banseon-maven2</id> 
                <name>Banseon-maven2 Snapshot Repository</name> 
                <url>scp://svn.baidu.com/banseon:/usr/local/maven-snapshot</url>  
       <layout/>
      </snapshotRepository> 
        
            <site> 
               
                <id>banseon-site</id>  
                
                <name>business api website</name>  
                
                <url>  
                    scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web   
                </url>  
            </site> 
      
      <downloadUrl/> 
      
      <relocation> 
       
       <groupId/> 
       
       <artifactId/> 
       
       <version/> 
       
       <message/>
      </relocation>
      
      <status/>        
        </distributionManagement> 
        
        <properties/>
    </project>

所有的 Maven 项目都有一个 POM 文件，所有的 POM 文件都必须有 project 元素和 3 个必填字段：**`groupId、artifactId 以及 version`**，其他都是可选的。而这三项也可以称之为Maven坐标。坐标的作用就是定位当前Jar包的位置！有了他的位置，我们想要使用的时候只需要在项目的pom当中引入，maven即可根据坐标来查找下载使用。

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    	<modelVersion>4.0.0</modelVersion>
    	<groupId>com.gzl.cn</groupId>
    	<artifactId>helloMaven</artifactId>
    	<version>0.0.1-SNAPSHOT</version>
    	<name>helloMaven</name>
    	<description>Demo project for Spring Boot</description>
    	<packaging>jar</packaging>
    </project>

*  **modelVersion：** 描述这个POM文件是遵从哪个版本的项目描述符，一般不需要管。
 *  **groupId：** 项目组 ID，定义当前 Maven 项目隶属的组织或公司，通常是唯一的。它的取值一般是项目所属公司或组织的网址或 URL 的反写，例如 net.biancheng.www。
 *  **artifactId：** 项目 ID，通常是项目的名称。groupId 和 artifactId 一起定义了项目在仓库中的位置。
 *  **version：** 项目版本。
 *  **name：** name只是一个名称，项目的全名称，可以是大写空格多个词，比如Spring Boot Starter Parent，而artifactId是用来区分同一个groupId下的子项目，一般实际使用中，会把name的值赋成和artifactId一样的。
 *  **description：** 对当前项目的描述
 *  **packaging：** 项目的打包方式，默认值为 jar。有三个可选值：jar、war、pom
 *  **url：** 提供examlie网站展示的项目说明

**`无论 POM 文件中是否显示的声明，所有的 POM 均继承自一个父 POM`**，这个父 POM 被称为 `Super POM`。在pom的继承关系中，`子pom可以覆盖父pom中的配置`；`如果子pom没有覆盖，那么父pom中的配置将会被继承`。按照这个规则，继承关系中的所有pom叠加到一起，就`生成一个最终生效的pom`。maven实际运行的过程中，执行构建操作就是按照这个`最终的pom`运行起来的。最终的pom也叫作有效pom翻译为`effective POM`，通过`mvn help:effective-pom` 命令就可以查看项目的最终生成的pom（有效的pom）。

关于`mvn help:effective-pom` 命令的详解：[https://blog.csdn.net/weixin\_43888891/article/details/130483451][https_blog.csdn.net_weixin_43888891_article_details_130483451]

**我们使用和配置的POM其实大致是由三个层次组成的：**

1.  超级Pom：所有POM默认继承，创建一个空的项目，然后执行`mvn help:effective-pom` 命令就可以通过最终的pom来得出默认继承的配置。
2.  父POM：这一层可能没有，可能有一层，也可能有很多层，如果是springboot项目，我们往往会在pom.xml当中继承一个`spring-boot-starter-parent`。当然可能有的项目也不使用这个，而是直接引用`spring-boot-dependencies`的依赖。关于`spring-boot-starter-parent`详解：[https://blog.csdn.net/weixin\_43888891/article/details/130520345][https_blog.csdn.net_weixin_43888891_article_details_130520345]
3.  当前pom.xml配置的POM：我们项目使用的一层。

在运行、编译的时候maven会生效这三层合并出来的pom。

### 四、创建 Maven 项目 ###

Maven 提供了大量不同类型的 Archetype 模板，通过它们可以帮助用户快速的创建 Java 项目，其中最简单的模板就是 `maven-archetype-quickstart`，它只需要用户提供项目最基本的信息，就能生成项目的基本结构及 POM 文件，在cmd执行如下命令即可创建项目：

mvn archetype:generate -DgroupId=com.gzl.cn -DartifactId=helloMaven -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

经常使用ide来创建项目，一般很少有人知道其实通过命令也是可以创建项目的。

参数说明：

*  \-DgroupId: 项目组 ID，通常为组织名或公司网址的反写。
 *  \-DartifactId: 项目名。
 *  \-DarchetypeArtifactId: 指定 ArchetypeId，maven-archetype-quickstart 用于快速创建一个简单的 Maven 项目。
 *  \-DinteractiveMode: 是否使用交互模式。

使用命令创建好的项目如下：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 1][]

### 五、Maven项目的构建与测试 ###

构建项目：`mvn clean package` 项目构建完成后，在该项目根目录中生成了一个名为 `target` 的目录，该目录包含以下内容。

> 其中 clean 负责清理 target 目录，package 负责将项目构建并打包输出为 jar 文件。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 2][]

*  classes：源代码编译后存放在该目录中（存放.class文件）。`.java 转换为 .class 的过程称为编译阶段`
 *  test-classes：测试源代码编译后并存放在该目录中。
 *  surefire-reports：Maven 运行测试用例生成的测试报告存放在该目录中。
 *  helloMaven-1.0-SNAPSHOT.jar：Maven 对项目进行打包生成的 jar 文件。jar包默认的命名规则是项目名+版本号

> `.java`文件在编译后会变为`.class`文件，存放于`target\classes`文件夹下，`.class`文件并不是二进制文件，计算机是无法直接识别的，其次不同的操作系统之间也是有差异的，所以jvm就出现了，java程序实际上运行在jvm当中，由jvm来屏蔽操作系统之间的差异。在不同的操作系统中安装对应系统的jvm，便做到了一次编译，到处运行。

通过java命令运行class字节码：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 3][]

**两个命令的区别：**

*  mvn clean compile：清除+编译
 *  mvn clean package：清除+编译+打包

> idea运行的代码实际上就是运行的target目录下的class文件，idea他是有自动编译的，当代码发生了变化，我们运行main方法的时候他会自动进行编译的。除此外我们也可以通过`mvn clean compile` 命令进行手动编译。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 4][]

假如不进行编译，会发现classes文件夹当中并没有我们新增的类。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 5][]

### 六、Maven依赖 ###

当 Maven 项目需要声明某一个依赖时，通常只需要在其 POM 中配置该依赖的坐标信息，Maven 会根据坐标自动将依赖下载到项目中。例如，某个项目中使用 servlet-api 作为其依赖，其配置如下:

<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/maven-v4_0_0.xsd">
    ...
        <dependencies>
            <dependency>
                <groupId>javax.servlet</groupId>
                <artifactId>servlet-api</artifactId>
                <version>2.5</version>
                <scope>provided</scope>
            </dependency>
        </dependencies>
    </project>

`dependencies 元素可以包含一个或者多个 dependency 子元素`，用以声明一个或者多个项目依赖，每个dependency 元素下都可以包含以下元素：

（1）groupId、artifactId 和 version：依赖的基本坐标，对于任何一个依赖来说，基本坐标是最重要的，Maven根据坐标才能找到需要的依赖。  
（2）type：依赖的类型，对应于项目坐标定义的 packaging。大部分情况下，该元素不必声明，其默认值是 jar。有三个可选值：jar、war、pom  
（3）optional：标记依赖是否可选。是否会传递依赖，默认是false传递依赖。  
（4）scope：依赖的范围。  
（5）exclusions：用来排除传递性依赖。

需要什么依赖直接上官网找即可：[https://mvnrepository.com/][https_mvnrepository.com]

关于依赖的传递、依赖的作用范围、排除依赖、依赖的管理等等，可以这一篇文章：

[https://blog.csdn.net/weixin\_43888891/article/details/130517016][https_blog.csdn.net_weixin_43888891_article_details_130517016]

### 七、Maven仓库（本地仓库+远程仓库） ###

`Maven 在某个统一的位置存储所有项目的构件，这个统一的位置，我们就称之为仓库。`换言之，仓库就是存放依赖和插件的地方。项目构建完成生成的构件，也可以安装或者部署到仓库中，供其他项目使用。

**Maven 仓库可以分为 2 个大类：**

*  本地仓库
 *  远程仓库

**当 Maven 根据坐标寻找构件时：**

1.  它会首先查看本地仓库，若本地仓库存在此构件，则直接使用；
2.  若本地仓库不存在此构件，Maven 就会去远程仓库查找，若发现所需的构件后，则下载到本地仓库使用。
3.  如果本地仓库和远程仓库都没有所需的构件，则 Maven 就会报错。

**远程仓库还可以分为 3 个小类：中央仓库、私服、其他公共仓库。**

*  中央仓库是由 Maven 社区提供的一种特殊的远程仓库，它包含了绝大多数流行的开源构件。在默认情况下，当本地仓库没有 Maven所需的构件时，会首先尝试从中央仓库下载（注：需要通过网络才能访问）。
 *  私服是一种特殊的远程仓库，它通常设立在局域网内，用来代理所有外部的远程仓库。它的好处是可以节省带宽，比外部的远程仓库更加稳定。
 *  除了中央仓库和私服外，还有很多其他公共仓库，例如 JBoss Maven 库，Java.net Maven 库等等。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 6][]

**本地仓库：** 本地仓库实际上就是本地计算机上的一个目录（文件夹），它会在第一次执行 Maven 命令时被创建。Maven 本地仓库默认地址为 C:%USER\_HOME%.m2\\repository ，可以修改：

> Maven 本地仓库可以储存本地所有项目所需的构件。当 Maven 项目第一次进行构建时，会自动从远程仓库搜索依赖项，并将其下载到本地仓库中。当项目再进行构建时，会直接从本地仓库搜索依赖项并引用，而不会再次向远程仓库获取。

> 构件想要进入本地仓库，除了从远程仓库下载到本地仓库外，还可以使用命令 `mvn install` 将本地项目的输出构件安装到本地仓库中。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 7][]

入门demo练习：[https://blog.csdn.net/weixin\_43888891/article/details/109063669][https_blog.csdn.net_weixin_43888891_article_details_109063669]

### 八、Maven生命周期（clean+site+default） ###

[https://blog.csdn.net/weixin\_43888891/article/details/130756192][https_blog.csdn.net_weixin_43888891_article_details_130756192]

### 九、Maven常用插件 ###

[https://blog.csdn.net/weixin\_43888891/article/details/130549878][https_blog.csdn.net_weixin_43888891_article_details_130549878]

### 十、Maven 版本号约定 ###

**通常情况下，Maven 的版本号约定中包括如下几个部分：**

<主版本号>.<次版本号>.<增量版本号>.<里程碑版本号>

*  主版本号：主版本号表示该项目的重大升级。例如：Maven1 到 Maven2；
 *  次版本号：表示在该主版本下，较大范围的升级或变化。例如：Maven-3.0 到 Maven-3.1；
 *  增量版本号：增量版本通常是用来修复bug的版本。例如：Maven-3.1.1；
 *  里程碑版本号：用来标记里程碑版本。例如：Maven-3.0-alpha-3。

由于 Maven 已经维护了将近 20 年，所以，使用 Maven 这个项目的版本演变过程来举例是再合适不过了。我们打开 Maven 的官网，找到 Release Notes，打开便可以看到 Maven 从最开始的版本是如何演变成现在的模样的。（这里由于存在太多版本，所以，我们只截取了其中一部分）

官网：[https://maven.apache.org/docs/history.html][https_maven.apache.org_docs_history.html]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 8][]

注意： 有的同学可能会问，里程碑版本里面的 alpha，beat 是什么意思？

*  alpha 版本： alpha 版本被称为是内测版本。通常会存在比较多 bug，主要是面向测试人员使用；
 *  beat 版本： 这个版本也是测试版本。会比 alpha 版本新增加一些功能；
 *  RC 版本： 即将发布的候选版本。这个阶段不会再新增功能，主要用于修复 Bug；
 *  GA 版本： 正式发布版本，也可以对应于 release 版本。

这些版本号在一些流行的框架的演变过程中非常常见。

### 十一、Maven SNAPSHOT(快照) ###

在我们是实际开发的项目当中很少会定义beat 、alpha 版本等等，因为这些一般都是开源框架才会定义的，而我们经常在开发中会定义SNAPSHOT版本。SNAPSHOT不同于里程碑版本，里程碑版本他也就是一个普通的版本名称，说白了只是用这些英文来代表这个版本的含义，而SNAPSHOT是有特殊功能的。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 9][]

**使用场景：** 大型的应用软件通常由多个功能模块组成，这些模块有时候分别于不同的团队负责开发。假设有两个团队，他们分别负责项目中的 member-service（会员服务） 和 user-service（用户服务） 两个模块，且 member-service 需要依赖 user-service 项目。

基于以上假设，若 user-service 团队正在进行快节奏的 bug 修复及功能增强，会在短时间内高频率地更新代码以及发布版本。就会出现以下情况：

*  user-service 团队每次发布新版本更新代码时，都应该通知member-service团队。
 *  member-service 团队则需要定期更新其 pom.xml 以获得最新的版本。

这样，势必会影响开发效率，甚至会影响项目的验收及投产。要解决这个问题，其实很简单，那就是使用 SNAPSHOT（快照）版本。

**版本介绍：** SNAPSHOT（快照）是一种特殊的版本，它表示当前开发进度的副本。与常规版本不同，`快照版本的构件在发布时，Maven 会自动为它打上一个时间戳，有了这个时间戳后，当依赖该构件的项目进行构建时，Maven 就能从仓库中找到最新的 SNAPSHOT 版本文件。`

默认情况下对于快照本本的构件，Maven 会每天从仓库中获取一次更新，用户也可以在任何 Maven 命令中使用 -U 参数强制 Maven 检查更新。命令如下：`mvn clean package -U`

**SNAPSHOT 版本 VS RELEASE 版本**

> Maven 仓库分为两种，Snapshot 快照仓库和 Release 发行仓库。Snapshot 快照仓库用于保存开发过程中的不稳定 SNAPSHOT 版本，Release 发行仓库则用来保存稳定的 RELEASE 版本。Maven 会根据模块的版本号（pom.xml 文件中的 version 元素）中是否带有 -SNAPSHOT 来判断是 SNAPSHOT 版本还是正式 RELEASE 版本。带有 -SNAPSHOT 是SNAPSHOT（快照）版本，不带 -SNAPSHOT 的就是正式 RELEASE（发布）版本。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 10][]

### 十二、Maven继承 ###

这篇文章讲解了Maven的继承、Maven父子工程以及Maven聚合工程：[https://blog.csdn.net/weixin\_43888891/article/details/130732237][https_blog.csdn.net_weixin_43888891_article_details_130732237]

### 十三、profiles多环境配置 ###

[https://blog.csdn.net/weixin\_43888891/article/details/130794308][https_blog.csdn.net_weixin_43888891_article_details_130794308]

### 十四、使用maven引入第三方jar包以及打包 ###

[https://blog.csdn.net/weixin\_43888891/article/details/130611728][https_blog.csdn.net_weixin_43888891_article_details_130611728]

### 十五、关于微服务项目打包 ###

[https://blog.csdn.net/weixin\_43888891/article/details/125630594][https_blog.csdn.net_weixin_43888891_article_details_125630594]

### 十六、Maven内置属性 ###

1、maven有一些内置属性，也就是我们不需要任何声明，只需要通过如下命令即可使用，常用的POM属性包括：

*  `${project.build.sourceDirectory}`：项目的主源码目录，默认为 src/main/java
 *  `${project.build.testSourceDirectory}`：项目的测试源码目录，默认为 src/test/java
 *  `${project.build.directory}`：项目构件输出目录，默认为 target/
 *  `${project.outputDirectory}`：项目主代码编译输出目录，默认为 target/classes/
 *  `${project.testOutputDirectory}`：项目测试代码编译输出目录，默认为 target/test-classes/
 *  `${project.groupId}`：项目的 groupId
 *  `${project.artifactId}`：项目的 artifactId
 *  `${project.version}`：项目的 version，与`${version}`等价
 *  `${project.build.fianlName}`：项目打包输出文件的名称。默认为`${project.artifactId}-${project.version}`
 *  `${project.basedir}`：项目所在的目录
 *  `${maven.build.timestamp}`：表示项目构建开始时间（2023-05-25T14:18:42Z）

2、自定义属性（在pom.xml文件的`<properties>`标签下定义的Maven属性）

定义属性：

使用属性：

<dependency>
    　　　<groupId>mysql</groupId>
    　　　<artifactId>mysql-connector-java</artifactId>
    　　　<version>${mysql.version}</version>
    </dependency>

3、setting.xml文件属性（与pom属性同理，用户可以用settings.开头的属性引用setting.xml文件的xml元素值）

*  `${settings.localRepository}`：表示本地仓库的地址

4、Java系统属性（所有的Java属性都可以使用Maven属性引用）

*  `mvn help:system`：可以查看所有的可以调用的属性，包含的有环境变量，系统属性，系统属性直接使用`${属性名}`即可调用
 *  在java中可以通过`System.getProperties()` 得到所有的Java属性

5、环境变量属性（所有的环境变量都可以以env.开头的Maven属性引用）

*  `mvn help:system`：可查看所有的环境变量
 *  `${env.JAVA_HOME}` ：表示JAVA\_HOME环境变量的值

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/418d3dc15df54edc95e1664991ce0b7a.png
[https_blog.csdn.net_weixin_43888891_article_details_128623086]: https://blog.csdn.net/weixin_43888891/article/details/128623086
[https_blog.csdn.net_weixin_43888891_article_details_130483451]: https://blog.csdn.net/weixin_43888891/article/details/130483451
[https_blog.csdn.net_weixin_43888891_article_details_130520345]: https://blog.csdn.net/weixin_43888891/article/details/130520345
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/182a0fef08044d828a9efa26227edc56.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 2]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/5f96c601982d45cb947d49b4b69f6846.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 3]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/cc7a6bfa13db45b4948312b858d0d4e7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 4]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/f86eee5e7d66470896a8d609532a06d6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 5]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/1ef8bd9fdb9c43ddba2be239801507c1.png
[https_mvnrepository.com]: https://mvnrepository.com/
[https_blog.csdn.net_weixin_43888891_article_details_130517016]: https://blog.csdn.net/weixin_43888891/article/details/130517016?spm=1001.2014.3001.5501
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 6]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/c21d5b9439d9416199ff7ff0ea7f7403.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 7]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/e2eec6b852e540ff86147319304ae886.png
[https_blog.csdn.net_weixin_43888891_article_details_109063669]: https://blog.csdn.net/weixin_43888891/article/details/109063669
[https_blog.csdn.net_weixin_43888891_article_details_130756192]: https://blog.csdn.net/weixin_43888891/article/details/130756192
[https_blog.csdn.net_weixin_43888891_article_details_130549878]: https://blog.csdn.net/weixin_43888891/article/details/130549878
[https_maven.apache.org_docs_history.html]: https://maven.apache.org/docs/history.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 8]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/ca218b78c3aa44d19940872c47f74c41.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 9]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/0b0cd2045e864d0994993e017793e25d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NjEwMTgzOQ_size_16_color_FFFFFF_t_70 10]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/77838422dee84c79b42809c1196bf225.png
[https_blog.csdn.net_weixin_43888891_article_details_130732237]: https://blog.csdn.net/weixin_43888891/article/details/130732237
[https_blog.csdn.net_weixin_43888891_article_details_130794308]: https://blog.csdn.net/weixin_43888891/article/details/130794308
[https_blog.csdn.net_weixin_43888891_article_details_130611728]: https://blog.csdn.net/weixin_43888891/article/details/130611728
[https_blog.csdn.net_weixin_43888891_article_details_125630594]: https://blog.csdn.net/weixin_43888891/article/details/125630594