Maven pom.xml 全配置（一）常用配置

這里貼出一個Maven中出現(xiàn)頻率較高的配置參數(shù)注釋，方便理解項(xiàng)目中Maven的配置具體的作用。如果在此博文中沒有找到你想看到的參數(shù)，可以移步Maven pom.xml 全配置（二）不常用配置

<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 "> <!-- 父項(xiàng)目的坐標(biāo)。如果項(xiàng)目中沒有規(guī)定某個元素的值，那么父項(xiàng)目中的對應(yīng)值即為項(xiàng)目的默認(rèn)值。坐標(biāo)包括group ID，artifact ID和 version。 --> <parent> <!-- 被繼承的父項(xiàng)目的構(gòu)件標(biāo)識符 --> <artifactId>xxx</artifactId><!-- 被繼承的父項(xiàng)目的全球唯一標(biāo)識符 --><groupId>xxx</groupId> <!-- 被繼承的父項(xiàng)目的版本 --> <version>xxx</version><!-- 父項(xiàng)目的pom.xml文件的相對路徑。相對路徑允許你選擇一個不同的路徑。默認(rèn)值是../pom.xml。Maven首先在構(gòu)建當(dāng)前項(xiàng)目的地方尋找父項(xiàng)目的pom，其次在文件系統(tǒng)的這個位置（relativePath位置），然后在本地倉庫，最后在遠(yuǎn)程倉庫尋找父項(xiàng)目的pom。 --> <relativePath>xxx</relativePath> </parent> <!-- 聲明項(xiàng)目描述符遵循哪一個POM模型版本。模型本身的版本很少改變，雖然如此，但它仍然是必不可少的，這是為了當(dāng)Maven引入了新的特性或者其他模型變更的時候，確保穩(wěn)定性。 --> <modelVersion> 4.0.0 </modelVersion> <!-- 項(xiàng)目的全球唯一標(biāo)識符，通常使用全限定的包名區(qū)分該項(xiàng)目和其他項(xiàng)目。并且構(gòu)建時生成的路徑也是由此生成， 如com.mycompany.app生成的相對路徑為：/com/mycompany/app --> <groupId>xxx</groupId> <!-- 構(gòu)件的標(biāo)識符，它和group ID一起唯一標(biāo)識一個構(gòu)件。換句話說，你不能有兩個不同的項(xiàng)目擁有同樣的artifact ID和groupID；在某個特定的group ID下，artifact ID也必須是唯一的。構(gòu)件是項(xiàng)目產(chǎn)生的或使用的一個東西，Maven為項(xiàng)目產(chǎn)生的構(gòu)件包括：JARs，源碼，二進(jìn)制發(fā)布和WARs等。 --> <artifactId>xxx</artifactId> <!-- 項(xiàng)目當(dāng)前版本，格式為:主版本.次版本.增量版本-限定版本號 --> <version> 1.0-SNAPSHOT </version> <!-- 項(xiàng)目產(chǎn)生的構(gòu)件類型，例如jar、war、ear、pom。插件可以創(chuàng)建他們自己的構(gòu)件類型，所以前面列的不是全部構(gòu)件類型 --> <packaging> jar </packaging> <!-- 項(xiàng)目的名稱, Maven產(chǎn)生的文檔用 --> <name> xxx-maven </name> <!-- 項(xiàng)目主頁的URL, Maven產(chǎn)生的文檔用 --> <url> http://maven.apache.org </url> <!-- 項(xiàng)目的詳細(xì)描述, Maven 產(chǎn)生的文檔用。 當(dāng)這個元素能夠用HTML格式描述時（例如，CDATA中的文本會被解析器忽略，就可以包含HTML標(biāo)簽）， 不鼓勵使用純文本描述。如果你需要修改產(chǎn)生的web站點(diǎn)的索引頁面，你應(yīng)該修改你自己的索引頁文件，而不是調(diào)整這里的文檔。 --> <description> A maven project to study maven. </description> <!-- 模塊（有時稱作子項(xiàng)目） 被構(gòu)建成項(xiàng)目的一部分。列出的每個模塊元素是指向該模塊的目錄的相對路徑 --> <modules><!--子項(xiàng)目相對路徑--><module></module></modules> <!-- 以值替代名稱，Properties可以在整個POM中使用，也可以作為觸發(fā)條件（見settings.xml配置文件里activation元素的說明）。格式是<name>value</name>。 --> <properties><name>value</name></properties> <!-- 繼承自該項(xiàng)目的所有子項(xiàng)目的默認(rèn)依賴信息。這部分的依賴信息不會被立即解析,而是當(dāng)子項(xiàng)目聲明一個依賴（必須描述group ID和artifact ID信息），如果group ID和artifact ID以外的一些信息沒有描述，則通過group ID和artifact ID匹配到這里的依賴，并使用這里的依賴信息。 --> <dependencyManagement> <dependencies> <!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> </dependencyManagement> <!-- 該元素描述了項(xiàng)目相關(guān)的所有依賴。 這些依賴組成了項(xiàng)目構(gòu)建過程中的一個個環(huán)節(jié)。它們自動從項(xiàng)目定義的倉庫中下載。要獲取更多信息，請看項(xiàng)目依賴機(jī)制。 --> <dependencies> <dependency> <!-- 依賴的group ID --> <groupId> org.apache.maven </groupId> <!-- 依賴的artifact ID --> <artifactId> maven-artifact </artifactId> <!-- 依賴的版本號。 在Maven 2里, 也可以配置成版本號的范圍。 --> <version> 3.8.1 </version> <!-- 依賴類型，默認(rèn)類型是jar。它通常表示依賴的文件的擴(kuò)展名，但也有例外。一個類型可以被映射成另外一個擴(kuò)展名或分類器。類型經(jīng)常和使用的打包方式對應(yīng)，盡管這也有例外。一些類型的例子：jar，war，ejb-client和test-jar。如果設(shè)置extensions為 true，就可以在plugin里定義新的類型。所以前面的類型的例子不完整。 --> <type> jar </type> <!-- 依賴的分類器。分類器可以區(qū)分屬于同一個POM，但不同構(gòu)建方式的構(gòu)件。分類器名被附加到文件名的版本號后面。例如，如果你想要構(gòu)建兩個單獨(dú)的構(gòu)件成JAR，一個使用Java 1.4編譯器，另一個使用Java 6編譯器，你就可以使用分類器來生成兩個單獨(dú)的JAR構(gòu)件。 --> <classifier></classifier> <!-- 依賴范圍。在項(xiàng)目發(fā)布過程中，幫助決定哪些構(gòu)件被包括進(jìn)來。欲知詳情請參考依賴機(jī)制。 - compile ：默認(rèn)范圍，用于編譯 - provided：類似于編譯，但支持你期待jdk或者容器提供，類似于classpath - runtime: 在執(zhí)行時需要使用 - test: 用于test任務(wù)時使用 - system: 需要外在提供相應(yīng)的元素。通過systemPath來取得 - systemPath: 僅用于范圍為system。提供相應(yīng)的路徑 - optional: 當(dāng)項(xiàng)目自身被依賴時，標(biāo)注依賴是否傳遞。用于連續(xù)依賴時使用 --> <scope> test </scope> <!-- 僅供system范圍使用。注意，不鼓勵使用這個元素，并且在新的版本中該元素可能被覆蓋掉。該元素為依賴規(guī)定了文件系統(tǒng)上的路徑。需要絕對路徑而不是相對路徑。推薦使用屬性匹配絕對路徑，例如${java.home}。 --> <systemPath></systemPath> <!-- 當(dāng)計(jì)算傳遞依賴時， 從依賴構(gòu)件列表里，列出被排除的依賴構(gòu)件集。即告訴maven你只依賴指定的項(xiàng)目，不依賴項(xiàng)目的依賴。此元素主要用于解決版本沖突問題 --> <exclusions> <exclusion> <artifactId> spring-core </artifactId> <groupId> org.springframework </groupId> </exclusion> </exclusions> <!-- 可選依賴，如果你在項(xiàng)目B中把C依賴聲明為可選，你就需要在依賴于B的項(xiàng)目（例如項(xiàng)目A）中顯式的引用對C的依賴?？蛇x依賴阻斷依賴的傳遞性。 --> <optional> true </optional> </dependency> </dependencies> <!-- 構(gòu)建項(xiàng)目需要的信息 --> <build> <!-- 該元素設(shè)置了項(xiàng)目源碼目錄，當(dāng)構(gòu)建項(xiàng)目的時候，構(gòu)建系統(tǒng)會編譯目錄里的源碼。該路徑是相對于pom.xml的相對路徑。 --> <sourceDirectory></sourceDirectory> <!-- 該元素設(shè)置了項(xiàng)目腳本源碼目錄，該目錄和源碼目錄不同：絕大多數(shù)情況下，該目錄下的內(nèi)容會被拷貝到輸出目錄(因?yàn)槟_本是被解釋的，而不是被編譯的)。 --> <scriptSourceDirectory></scriptSourceDirectory> <!-- 該元素設(shè)置了項(xiàng)目單元測試使用的源碼目錄，當(dāng)測試項(xiàng)目的時候，構(gòu)建系統(tǒng)會編譯目錄里的源碼。該路徑是相對于pom.xml的相對路徑。 --> <testSourceDirectory></testSourceDirectory> <!-- 被編譯過的應(yīng)用程序class文件存放的目錄。 --> <outputDirectory></outputDirectory> <!-- 被編譯過的測試class文件存放的目錄。 --> <testOutputDirectory></testOutputDirectory> <!-- 使用來自該項(xiàng)目的一系列構(gòu)建擴(kuò)展 --> <extensions> <!-- 描述使用到的構(gòu)建擴(kuò)展。 --> <extension> <!-- 構(gòu)建擴(kuò)展的groupId --> <groupId></groupId> <!-- 構(gòu)建擴(kuò)展的artifactId --> <artifactId></artifactId> <!-- 構(gòu)建擴(kuò)展的版本 --> <version></version> </extension> </extensions> <!-- 當(dāng)項(xiàng)目沒有規(guī)定目標(biāo)（Maven2 叫做階段）時的默認(rèn)值 --> <defaultGoal></defaultGoal> <!-- 這個元素描述了項(xiàng)目相關(guān)的所有資源路徑列表，例如和項(xiàng)目相關(guān)的屬性文件，這些資源被包含在最終的打包文件里。 --> <resources> <!-- 這個元素描述了項(xiàng)目相關(guān)或測試相關(guān)的所有資源路徑 --> <resource> <!-- 描述了資源的目標(biāo)路徑。該路徑相對target/classes目錄（例如${project.build.outputDirectory}）。舉個例子，如果你想資源在特定的包里(org.apache.maven.messages)，你就必須該元素設(shè)置為org/apache/maven/messages。然而，如果你只是想把資源放到源碼目錄結(jié)構(gòu)里，就不需要該配置。 --> <targetPath></targetPath> <!-- 是否使用參數(shù)值代替參數(shù)名。參數(shù)值取自properties元素或者文件里配置的屬性，文件在filters元素里列出。 --> <filtering></filtering><!-- 描述存放資源的目錄，該路徑相對POM路徑 --> <directory></directory><!-- 包含的模式列表，例如**/*.xml. --> <includes><include></include></includes><!-- 排除的模式列表，例如**/*.xml --><excludes><exclude></exclude></excludes></resource> </resources> <!-- 這個元素描述了單元測試相關(guān)的所有資源路徑，例如和單元測試相關(guān)的屬性文件。 --> <testResources> <!-- 這個元素描述了測試相關(guān)的所有資源路徑，參見build/resources/resource元素的說明 --> <testResource> <!-- 描述了測試相關(guān)的資源的目標(biāo)路徑。該路徑相對target/classes目錄（例如${project.build.outputDirectory}）。舉個例子，如果你想資源在特定的包里(org.apache.maven.messages)，你就必須該元素設(shè)置為org/apache/maven/messages。然而，如果你只是想把資源放到源碼目錄結(jié)構(gòu)里，就不需要該配置。 --> <targetPath></targetPath> <!-- 是否使用參數(shù)值代替參數(shù)名。參數(shù)值取自properties元素或者文件里配置的屬性，文件在filters元素里列出。 --> <filtering></filtering><!-- 描述存放測試相關(guān)的資源的目錄，該路徑相對POM路徑 --> <directory></directory><!-- 包含的模式列表，例如**/*.xml. --> <includes><include></include></includes><!-- 排除的模式列表，例如**/*.xml --><excludes><exclude></exclude></excludes> </testResource> </testResources> <!-- 構(gòu)建產(chǎn)生的所有文件存放的目錄 --> <directory></directory> <!-- 產(chǎn)生的構(gòu)件的文件名，默認(rèn)值是${artifactId}-${version}。 --> <finalName></finalName> <!-- 當(dāng)filtering開關(guān)打開時，使用到的過濾器屬性文件列表 --> <filters></filters> <!-- 子項(xiàng)目可以引用的默認(rèn)插件信息。該插件配置項(xiàng)直到被引用時才會被解析或綁定到生命周期。給定插件的任何本地配置都會覆蓋這里的配置 --> <pluginManagement> <!-- 使用的插件列表 。 --> <plugins> <!-- plugin元素包含描述插件所需要的信息。 --> <plugin> <!-- 插件在倉庫里的group ID --> <groupId></groupId> <!-- 插件在倉庫里的artifact ID --> <artifactId></artifactId> <!-- 被使用的插件的版本（或版本范圍） --> <version></version> <!-- 是否從該插件下載Maven擴(kuò)展（例如打包和類型處理器），由于性能原因，只有在真需要下載時，該元素才被設(shè)置成enabled。 --> <extensions>true/false</extensions> <!-- 在構(gòu)建生命周期中執(zhí)行一組目標(biāo)的配置。每個目標(biāo)可能有不同的配置。 --> <executions> <!-- execution元素包含了插件執(zhí)行需要的信息 --> <execution> <!-- 執(zhí)行目標(biāo)的標(biāo)識符，用于標(biāo)識構(gòu)建過程中的目標(biāo)，或者匹配繼承過程中需要合并的執(zhí)行目標(biāo) --> <id></id><!-- 綁定了目標(biāo)的構(gòu)建生命周期階段，如果省略，目標(biāo)會被綁定到源數(shù)據(jù)里配置的默認(rèn)階段 --> <phase></phase><!-- 配置的執(zhí)行目標(biāo) --> <goals></goals> <!-- 配置是否被傳播到子POM --> <inherited>true/false</inherited> <!-- 作為DOM對象的配置 --> <configuration></configuration></execution> </executions> <!-- 項(xiàng)目引入插件所需要的額外依賴 --> <dependencies><!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> <!-- 任何配置是否被傳播到子項(xiàng)目 --> <inherited>true/false</inherited><!-- 作為DOM對象的配置 --> <configuration></configuration></plugin> </plugins> </pluginManagement> <!-- 該項(xiàng)目使用的插件列表 。 --> <plugins> <!-- plugin元素包含描述插件所需要的信息。 --> <plugin> <!-- 插件在倉庫里的group ID --> <groupId></groupId> <!-- 插件在倉庫里的artifact ID --> <artifactId></artifactId> <!-- 被使用的插件的版本（或版本范圍） --> <version></version> <!-- 是否從該插件下載Maven擴(kuò)展（例如打包和類型處理器），由于性能原因，只有在真需要下載時，該元素才被設(shè)置成enabled。 --> <extensions>true/false</extensions> <!-- 在構(gòu)建生命周期中執(zhí)行一組目標(biāo)的配置。每個目標(biāo)可能有不同的配置。 --> <executions> <!-- execution元素包含了插件執(zhí)行需要的信息 --> <execution> <!-- 執(zhí)行目標(biāo)的標(biāo)識符，用于標(biāo)識構(gòu)建過程中的目標(biāo)，或者匹配繼承過程中需要合并的執(zhí)行目標(biāo) --> <id></id><!-- 綁定了目標(biāo)的構(gòu)建生命周期階段，如果省略，目標(biāo)會被綁定到源數(shù)據(jù)里配置的默認(rèn)階段 --> <phase></phase><!-- 配置的執(zhí)行目標(biāo) --> <goals></goals> <!-- 配置是否被傳播到子POM --> <inherited>true/false</inherited> <!-- 作為DOM對象的配置 --> <configuration></configuration></execution> </executions> <!-- 項(xiàng)目引入插件所需要的額外依賴 --> <dependencies><!-- 參見dependencies/dependency元素 --> <dependency> </dependency> </dependencies> <!-- 任何配置是否被傳播到子項(xiàng)目 --> <inherited>true/false</inherited> <!-- 作為DOM對象的配置 --> <configuration></configuration> </plugin> </plugins></build> <!-- 發(fā)現(xiàn)依賴和擴(kuò)展的遠(yuǎn)程倉庫列表。 --> <repositories> <!-- 包含需要連接到遠(yuǎn)程倉庫的信息 --> <repository> <!-- 如何處理遠(yuǎn)程倉庫里發(fā)布版本的下載 --> <releases> <!-- true或者false表示該倉庫是否為下載某種類型構(gòu)件（發(fā)布版，快照版）開啟。 --> <enabled><enabled> <!-- 該元素指定更新發(fā)生的頻率。Maven會比較本地POM和遠(yuǎn)程POM的時間戳。這里的選項(xiàng)是：always（一直），daily（默認(rèn)，每日），interval：X（這里X是以分鐘為單位的時間間隔），或者never（從不）。 --> <updatePolicy></updatePolicy> <!-- 當(dāng)Maven驗(yàn)證構(gòu)件校驗(yàn)文件失敗時該怎么做：ignore（忽略），fail（失敗），或者warn（警告）。 --> <checksumPolicy></checksumPolicy> </releases> <!-- 如何處理遠(yuǎn)程倉庫里快照版本的下載。有了releases和snapshots這兩組配置，POM就可以在每個單獨(dú)的倉庫中，為每種類型的構(gòu)件采取不同的策略。例如，可能有人會決定只為開發(fā)目的開啟對快照版本下載的支持。參見repositories/repository/releases元素 --> <snapshots> <enabled><enabled><updatePolicy></updatePolicy><checksumPolicy></checksumPolicy> </snapshots> <!-- 遠(yuǎn)程倉庫唯一標(biāo)識符?？梢杂脕砥ヅ湓趕ettings.xml文件里配置的遠(yuǎn)程倉庫 --> <id> banseon-repository-proxy </id> <!-- 遠(yuǎn)程倉庫名稱 --> <name> banseon-repository-proxy </name> <!-- 遠(yuǎn)程倉庫URL，按protocol://hostname/path形式 --> <url> http://192.168.1.169:9999/repository/ </url> <!-- 用于定位和排序構(gòu)件的倉庫布局類型-可以是default（默認(rèn)）或者legacy（遺留）。Maven 2為其倉庫提供了一個默認(rèn)的布局；然而，Maven 1.x有一種不同的布局。我們可以使用該元素指定布局是default（默認(rèn)）還是legacy（遺留）。 --> <layout> default </layout> </repository> </repositories> </project>

轉(zhuǎn)載于:https://www.cnblogs.com/keeya/p/11438911.html

總結(jié)

以上是生活随笔為你收集整理的Maven pom.xml 全配置（一）常用配置的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。