maven三個(gè)常用的插件使用介紹

更新時(shí)間：2021年12月21日 14:15:50 作者：畢小寶

大家好，本篇文章主要講的是maven三個(gè)常用的插件使用介紹，感興趣的同學(xué)趕快來(lái)看一看吧，對(duì)你有幫助的話記得收藏一下，方便下次瀏覽

背景

maven 常用的三個(gè)插件對(duì)打包有不同的作用：

maven-jar-plugin：處理 jar 包生成；

spring-boot-maven-plugin：SpringBoot 項(xiàng)目打包；

maven-assembly-plugin：自定義打包結(jié)構(gòu)。

而實(shí)際開(kāi)發(fā)過(guò)程中這三個(gè)插件可能都綜合使用，本文類(lèi)介紹混合使用這些插件時(shí)需要注意的事項(xiàng)。

SpringBoot 打包時(shí)排除文件

SpringBoot 項(xiàng)目打包時(shí)一般會(huì)抽出配置文件和靜態(tài)資源文件到指定目錄，然后通過(guò) --spring.config.additional-location=file:xxx 額外指定配置文件。

這樣的話，SpringBoot 打包時(shí)就需要排除配置文件和靜態(tài)資源文件，可以用 maven-ja-pluginr 插件來(lái)排除：

<plugin>
     <groupId>org.apache.maven.plugins</groupId>
     <artifactId>maven-jar-plugin</artifactId>
     <version>3.2.0</version>
     <configuration>
         <excludes>
             <exclude>*.yml</exclude>
             <exclude>static/**</exclude>
             <exclude>lib/**</exclude>
         </excludes>
     </configuration>
 </plugin>

注意：如果排除文件夾，需要后面兩個(gè)星星。

Spring 打包本地依賴(lài) jar

如果項(xiàng)目需要依賴(lài)本地某目錄下的 jar 包，而它又沒(méi)有在倉(cāng)庫(kù)中發(fā)布的話，可以通過(guò)如下方式添加依賴(lài)：

<dependency>
   <groupId>XXXX</groupId>
   <artifactId>XXX</artifactId>
   <version>1.0.0</version>
   <scope>system</scope>
  <systemPath>${project.basedir}/src/main/resources/lib/xxx.jar</systemPath>
</dependency>

值得注意的是，如果項(xiàng)目用了 SpringBoot 打包插件，默認(rèn)是不會(huì)將 system 作用域的 jar 打入 lib 目錄的，需要添加 includeSystemScope 配置將第三方 jar 包加入到 lib ：

<plugin>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-maven-plugin</artifactId>
     <configuration>
         <includeSystemScope>true</includeSystemScope>
     </configuration>
 </plugin>

編譯時(shí)排除指定文件

pom.xml 的 resources 配置可以對(duì)資源文件進(jìn)行篩選，常見(jiàn)配置如下：

<resources>
    <resource>
        <directory>src/main/resources</directory>
        <filtering>true</filtering>
        <excludes>
            <exclude>static/**</exclude>
            <exclude>*.yml</exclude>
        </excludes>
    </resource>
</resources>

該方式會(huì)直接影響編譯時(shí)資源文件的處理過(guò)程，即 target 目錄下的 classes 目錄中就不包括指定文件，從而導(dǎo)致本地運(yùn)行時(shí)缺少配置文件，所以開(kāi)發(fā)期間不建議用這種方式。

復(fù)制粘貼的原則

想起以前看到的一段經(jīng)典話語(yǔ)：

我從互聯(lián)網(wǎng)上得到的最好的經(jīng)驗(yàn)之一，就是永遠(yuǎn)不要復(fù)制和粘貼不是自己編寫(xiě)的代碼。如果你一定要復(fù)制，那就照著它逐字輸入，逼著自己思考，這些代碼實(shí)際上是什么意思。

除了代碼需要復(fù)制粘貼，平時(shí)文檔編寫(xiě)時(shí)也免不了拿舊文檔做模板。

word 文檔編寫(xiě)過(guò)程中，如果內(nèi)容是復(fù)制、粘貼的，我的經(jīng)驗(yàn)是，完成后必做幾項(xiàng)檢查：

標(biāo)題：檢查文檔中的標(biāo)題、系統(tǒng)名稱(chēng)是否更正為目標(biāo)文檔的內(nèi)容。目錄更正：文檔頁(yè)碼變化后，必須重新生成目錄與之對(duì)應(yīng)。修改內(nèi)容校對(duì)：修改過(guò)的內(nèi)容，需要校對(duì)至少三遍。