• 官網地址： https://maven.apache.org/
• 官方插件清單： https://maven.apache.org/plugins/index.html

Maven 是一個強大的構建工具，它提供了許多命令來進行項目構建、依賴管理和測試等操作。本文主要介紹一些常用的 Maven 命令。

在介紹 Maven 命令之前，需要從認知上理解 Maven 命令的構成。

Maven 命令主要分為兩種：

• mvn 命令參數：這里涵蓋了 mvn 后所有以 - 開頭的參數。
• mvn 插件命令：其實我們平時使用最多的 clean、package、install 等命令都是 Maven 官方提供的插件，除此之外我們還可以字節編寫插件進行擴展。

一、mvn 命令參數

mvn -v, --version 顯示版本信息。

mvn -V, --show-version 顯示版本信息后繼續執行 Maven 其他目標。

mvn -h, --help 顯示幫助信息。

mvn -e, --errors 控制 Maven 的日志級別，顯示執行錯誤相關的消息。

mvn -X, --debug 控制 Maven 的日志級別，顯示執行調試信息。

mvn -q, --quiet 控制 Maven 的日志級別，僅顯示錯誤信息。

mvn -Pxxx 激活 id 為 xxx 的 profile（如有多個，用逗號隔開）。

mvn -Dxxx=yyy 指定 java 的全局屬性。

mvn -o, --offline 運行 offline 模式，不聯網更新依賴。

mvn -N, --non-recursive 盡在當前項目模塊執行命令，不構建子模塊。

mvn -pl, --module_name 在指定模塊上執行命令。

mvn -ff, --fail-fast 遇到構建失敗就直接退出。

mvn -fn, --fail-never 無論項目結果如何，構建從不失敗。

mvn -fae, --fail-at-end 僅影響構建結果，允許不受影響的構建繼續。

mvn -C, --strict-checksums 如果校驗碼不匹配的話，構建失敗。

mvn -c, --lax-checksums 如果校驗碼不匹配的話，產生告警。

mvn -U 強制更新 SNAPSHOT 類型的插件或依賴庫（否則 Maven 一天只會更新一次 SNAPSHOT 依賴）。

mvn -npu, --no-plugin-updates 對任何相關的注冊插件，不進行最新檢查（使用該選項使 Maven 表現出穩定的行為，該穩定行為基于本地倉庫當前可用的所有插件版本）。

mvn -cpu, --check-plugin-updates 對任何相關的注冊插件，強制進行最新檢查（即使項目 POM 里明確規定了 Maven 插件版本，還是會強制更新）。

mvn -up, --update-plugins 與 mvn -cpu 作用相同。

mvn -B, --batch-mode 在非交互（批處理）模式下運行（該模式下，當 Maven 需要輸入時，它不會停下來接收用戶的輸入，而是使用合理的默認值）。

mvn -f, --file <file> 強制使用備用的 POM 文件。

mvn -s, --settings <arg> 用戶配置文件的備用路徑。

mvn -gs, --global-settings <file> 全局配置文件的備用路徑。

mvn -emp, --encrypt-master-password <password> 加密主安全密碼，存儲到 Maven 的 settings 文件里。

mvn -ep, --encrypt-password <password> 加密服務器密碼，存儲到 Maven 的 settings 文件里。

mvn -npr, --no-plugin-registry 對插件版本不適用 ~/.m2/plugin-registry.xml（插件注冊表）里的配置。

---

二、mvn 插件命令

1.介紹

其實我們平時使用最多的 clean、package、install 等命令都是 Maven 官方提供的插件，除此之外我們還可以字節編寫插件進行擴展。

官方插件清單： https://maven.apache.org/plugins/index.html

這里我們主要講解一下如何查看插件的官方文檔，以及常用的插件命令。

2.查看插件的使用文檔

Maven 的官方插件主要分為四類：

• 核心插件：包括 clean、compiler、deploy、install 等。
• 打包插件：包括 jar、war、ejb、source 等。
• 報告插件：包括 javadoc 等。
• 工具插件：包括 antrun、archetype、dependency、help 等。

查看 Maven 插件的官方文檔，這里我們主要用到了工具插件中的 help 插件。

用法：

mvn help:describe -Dplugin=插件名

例如：我想查看 dependency 命令的使用文檔：

mvn 命令：

mvn help:describe -Dplugin=dependency

執行結果：

補充： 如果之前沒有使用過 help 插件，第一次執行會先進行 Download，時間，后面就會直接執行了。

3.常用的插件命令

mvn clean：清理項目目錄，刪除 target 目錄和生成的構建文件。

mvn compile：編譯源代碼，并將編譯后的類文件存儲在 target 目錄中。

mvn test-compile：編譯測試代碼。

mvn test：運行項目的單元測試。

mvn site：產生 site。

mvn package：打包項目，并將生成的構建文件（例如：JAR、WAR）存儲在 target 目錄中。

mvn install：安裝項目到本地 Maven 倉庫，以供其他項目使用。

mvn deploy：將項目部署到遠程倉庫，例如 Maven 私服。

mvn clean install：清理項目目錄并執行安裝操作。

mvn clean package：清理項目目錄并執行打包操作。

mvn dependency:tree：顯示項目的依賴樹。

mvn dependency:resolve：解析項目的依賴關系，并下載缺失的依賴項。

mvn archetype:create

• mvn archetype:create -DgroupId=packageName -DartifactId=projectName：使用 Maven 的 archetype 插件，創建一個 Maven 的普通 java 項目。

• mvn archetype:create -DgroupId=packageName -DartifactId=projectName -DarchetypeArtifactId=maven-archetype-webapp：使用 Maven 的 archetype 插件，創建一個 Maven 的 Web 項目。

mvn archetype:generate：使用 Maven 的 archetype 插件，創建一個新的 Maven 項目結構。

mvn eclipse:eclipse：使用 Maven 的 eclipse 插件，生成 eclipse 項目。

mvn idea:idea：使用 Maven 的 idea 插件，生成 idea 項目。

mvn jar:jar：只打 jar 包。

mvn test -skipping compile -skipping test-compile：跳過源代碼的編譯和測試代碼的編譯，運行項目的單元測試。

mvn eclipse:clean：清除 eclipse 的一些系統設置。

mvn help:help：使用 Maven 的 help 插件，顯示 Maven 幫助信息。

以上這些命令是 Maven 中最常用的一些命令，可以根據項目需求和具體情況來選擇使用。同時，Maven 還提供了許多其他命令和插件，可以根據具體需求進行查閱和使用。你可以通過運行 mvn --help 來獲取所有可用的 Maven 命令，去官網插件清單查看所有可用插件。

整理完畢，完結撒花~ 🌻

參考地址：

1.maven常用命令大全(附詳細解釋)，https://blog.csdn.net/good_good_xiu/article/details/116740333

2.maven常用命令集合（收藏大全），https://zhuanlan.zhihu.com/p/355889432

3.Maven查看插件信息，https://blog.csdn.net/bugzeroman/article/details/120739886