Maven中常用命令完整版速查表(2026年最新)
更新時(shí)間：2026年04月15日 08:56:29 作者：蒙眼過河
日常開發(fā)中,熟練運(yùn)用?Maven?命令能大幅提升開發(fā)效率,本文整理了Maven常用命令速查表,涵蓋核心構(gòu)建,依賴管理,測試打包等場景,希望對(duì)大家有所幫助
引言：Maven 作為 Java 后端開發(fā)的核心構(gòu)建工具，貫穿項(xiàng)目編譯、測試、打包、依賴管理全流程。日常開發(fā)中，熟練運(yùn)用 Maven 命令能大幅提升開發(fā)效率，避免因命令不熟悉、參數(shù)使用不當(dāng)導(dǎo)致的構(gòu)建失敗。本文整理了 Maven 全場景常用命令，涵蓋核心生命周期、依賴管理、測試打包、項(xiàng)目輔助等模塊，重點(diǎn)補(bǔ)充了依賴清理的高級(jí)參數(shù)，所有命令可直接復(fù)制執(zhí)行，適配 Java 后端高頻開發(fā)場景，新手可收藏備查，老鳥可快速檢索。
一、核心生命周期命令
Maven 三大核心生命周期（clean、default、site），其中 default 生命周期是日常開發(fā)最常用的，以下命令覆蓋從清理到部署的全流程，建議熟練掌握。
| 命令 | 作用 | 常用場景 | 補(bǔ)充說明 |
|---|---|---|---|
| mvn clean | 刪除 target 構(gòu)建目錄 | 重新構(gòu)建前清理舊產(chǎn)物 | 默認(rèn)刪除 target，無額外參數(shù)，避免舊產(chǎn)物干擾新構(gòu)建 |
| mvn compile | 編譯 src/main/java 主代碼 | 快速檢查語法錯(cuò)誤、驗(yàn)證代碼編譯可行性 | 編譯后字節(jié)碼輸出到 target/classes 目錄 |
| mvn test | 編譯測試代碼 + 執(zhí)行單元測試 | 驗(yàn)證測試用例有效性、排查代碼邏輯問題 | 依賴 maven-surefire-plugin 插件，測試報(bào)告存于 target/surefire-reports |
| mvn package | 編譯 → 測試 → 打包（jar/war） | 生成可部署包，用于項(xiàng)目部署、測試環(huán)境驗(yàn)證 | 包文件存于 target 目錄，默認(rèn)生成 jar（普通項(xiàng)目）/war（web項(xiàng)目） |
| mvn install | 打包后安裝到本地 Maven 倉庫 | 本地多模塊項(xiàng)目依賴、自定義依賴復(fù)用（如自己開發(fā)的工具包） | 本地倉庫默認(rèn)路徑：~/.m2/repository，安裝后其他本地項(xiàng)目可直接依賴 |
| mvn deploy | 將包上傳到中央倉庫 | 團(tuán)隊(duì)共享依賴（如項(xiàng)目公共組件、工具類） | 需在 pom.xml 中配置遠(yuǎn)程倉庫地址（url、賬號(hào)密碼），否則無法上傳 |
| mvn validate | 校驗(yàn) POM 配置、項(xiàng)目結(jié)構(gòu)完整性 | 構(gòu)建前快速檢查配置錯(cuò)誤（如依賴缺失、POM 語法錯(cuò)誤） | 生命周期初始階段，執(zhí)行速度快，可快速排查基礎(chǔ)配置問題 |
| mvn verify | 執(zhí)行集成測試 + 校驗(yàn)包質(zhì)量 | 正式部署前驗(yàn)證包有效性（如集成測試是否通過、包是否符合規(guī)范） | 依賴 maven-failsafe-plugin 插件，集成測試類需以 *IT 結(jié)尾 |
常用組合命令（直接復(fù)制，日常開發(fā)高頻）
日常開發(fā)中，單獨(dú)執(zhí)行單個(gè)命令場景較少，以下組合命令覆蓋80%的構(gòu)建場景，建議直接復(fù)制使用：
# 標(biāo)準(zhǔn)構(gòu)建（清理→打包→安裝），跳過測試（加速構(gòu)建，避免測試耗時(shí)） mvn clean install -DskipTests # 強(qiáng)制更新快照依賴 + 構(gòu)建（依賴快照版本不更新時(shí)使用，如開發(fā)中的公共組件） mvn clean install -U -DskipTests # 只打包不安裝（生成部署包，用于服務(wù)器部署，無需安裝到本地倉庫） mvn clean package -DskipTests # 完整構(gòu)建（含測試，用于正式發(fā)布前驗(yàn)證，確保測試用例全部通過） mvn clean install
二、依賴管理命令
依賴管理是 Maven 的核心功能之一，日常開發(fā)中經(jīng)常遇到依賴沖突、依賴損壞、依賴缺失等問題，以下命令可快速排查和解決這些問題。
基礎(chǔ)依賴命令（必會(huì)）
| 命令 | 作用 | 示例 |
|---|---|---|
| mvn dependency:tree | 查看依賴樹，排查依賴沖突、傳遞依賴 | mvn dependency:tree（輸出到文件：-DoutputFile=deps.txt，方便后續(xù)分析） |
| mvn dependency:list | 列出項(xiàng)目所有直接/間接依賴，清晰查看依賴版本 | mvn dependency:list |
| mvn dependency:analyze | 分析未使用、缺失的依賴，優(yōu)化 POM 配置 | mvn dependency:analyze（可排查出冗余依賴，減少項(xiàng)目體積） |
| mvn dependency:copy-dependencies | 將所有依賴 jar 復(fù)制到指定目錄，方便手動(dòng)引用 | mvn dependency:copy-dependencies -DoutputDirectory=lib（復(fù)制到項(xiàng)目根目錄 lib 文件夾） |
| mvn dependency:get | 手動(dòng)下載指定 GAV 依賴到本地倉庫，解決依賴下載失敗問題 | mvn dependency:get -Dartifact=org.springframework:spring-core:5.3.23（指定 groupId:artifactId:version） |
dependency:purge-local-repository
本地依賴經(jīng)常出現(xiàn)損壞、版本錯(cuò)亂等問題，導(dǎo)致構(gòu)建失敗，dependency:purge-local-repository 是清理本地依賴的核心命令，以下高級(jí)參數(shù)可精準(zhǔn)控制清理范圍和行為，必記！
| 參數(shù) | 作用 | 完整命令示例 | 使用場景 |
|---|---|---|---|
| 默認(rèn)（無參數(shù)） | 刪除當(dāng)前項(xiàng)目所有依賴，自動(dòng)重新下載 | mvn dependency:purge-local-repository | 依賴損壞、版本錯(cuò)亂，需完全重置依賴（如構(gòu)建時(shí)報(bào)依賴找不到、依賴校驗(yàn)失?。?/td> |
| -DreResolve=false | 只刪除依賴，不重新下載 | mvn dependency:purge-local-repository -DreResolve=false | 僅清理舊依賴，后續(xù)手動(dòng)控制下載時(shí)機(jī)（如網(wǎng)絡(luò)不佳時(shí)，先清理再手動(dòng)下載） |
| -DactTransitively=false | 僅刪除直接依賴，不刪除傳遞依賴 | mvn dependency:purge-local-repository -DactTransitively=false | 只想重置直接依賴（如自己配置的依賴），保留傳遞依賴（避免重復(fù)下載，節(jié)省時(shí)間） |
| -DmanualInclude=“G:A” | 精確指定要?jiǎng)h除的單個(gè)/多個(gè)依賴 | 單個(gè)：mvn dependency:purge-local-repository -DmanualInclude=“junit:junit” 多個(gè)：mvn dependency:purge-local-repository -DmanualInclude=“junit:junit,org.slf4j:slf4j-api” | 特定依賴損壞（如某個(gè) jar 包損壞），無需清理所有依賴，精準(zhǔn)定位，節(jié)省時(shí)間 |
依賴清理組合命令（實(shí)用版，直接復(fù)制）
結(jié)合高級(jí)參數(shù)，整理了4個(gè)高頻依賴清理場景的組合命令，覆蓋大部分依賴問題排查場景：
# 1. 只刪除不下載（最常用，清理后手動(dòng)控制下載） mvn dependency:purge-local-repository -DreResolve=false # 2. 精確刪除指定依賴 + 不自動(dòng)下載（精準(zhǔn)清理，避免影響其他依賴） mvn dependency:purge-local-repository -DmanualInclude="com.alibaba:fastjson" -DreResolve=false # 3. 清理直接依賴 + 重新構(gòu)建（重置直接依賴，保留傳遞依賴，加速構(gòu)建） mvn dependency:purge-local-repository -DactTransitively=false clean install # 4. 清理所有依賴 + 重新下載 + 構(gòu)建（一鍵修復(fù)所有依賴問題，適合依賴完全錯(cuò)亂時(shí)） mvn dependency:purge-local-repository clean install
三、測試相關(guān)命令（含高級(jí)用法）
單元測試、集成測試是保證代碼質(zhì)量的關(guān)鍵，以下命令可靈活控制測試執(zhí)行，適配不同開發(fā)場景（如跳過測試、執(zhí)行單個(gè)測試用例）。
| 命令/參數(shù) | 作用 | 示例 |
|---|---|---|
| mvn test | 執(zhí)行所有單元測試，驗(yàn)證代碼邏輯正確性 | mvn test |
| -Dtest=測試類名 | 運(yùn)行單個(gè)測試類，排查特定測試類的問題 | mvn -Dtest=UserServiceTest test（UserServiceTest 為測試類名） |
| -Dtest=測試類名#方法名 | 運(yùn)行單個(gè)測試方法，精準(zhǔn)排查某個(gè)測試方法的問題 | mvn -Dtest=UserServiceTest#testGetById test（testGetById 為測試方法名） |
| -DskipTests | 跳過測試執(zhí)行，仍編譯測試代碼（保留測試代碼編譯校驗(yàn)） | mvn clean install -DskipTests（日常開發(fā)加速構(gòu)建，不影響測試代碼編譯） |
| -Dmaven.test.skip=true | 不編譯、不執(zhí)行測試代碼（最大化加速構(gòu)建） | mvn clean package -Dmaven.test.skip=true（僅需生成部署包，無需測試相關(guān)操作） |
| mvn failsafe:integration-test | 執(zhí)行集成測試（測試類名以 *IT 結(jié)尾），驗(yàn)證模塊間交互 | mvn failsafe:integration-test（正式發(fā)布前必執(zhí)行，驗(yàn)證項(xiàng)目整體可用性） |
四、打包與擴(kuò)展打包命令
項(xiàng)目開發(fā)完成后，需要打包為可部署格式，以下命令覆蓋常規(guī)打包、源碼打包、自定義打包等場景，適配不同部署需求。
| 命令 | 作用 | 示例 |
|---|---|---|
| mvn jar:jar | 僅打包主代碼為 jar 包，不執(zhí)行編譯、測試（需先編譯） | mvn jar:jar（適合已編譯完成，僅需重新打包的場景） |
| mvn war:war | 僅打包主代碼為 war 包（web 項(xiàng)目），不執(zhí)行編譯、測試 | mvn war:war（web 項(xiàng)目快速打包，適合已編譯完成的場景） |
| mvn source:jar | 打包源碼為 jar 包，供他人查看源碼（如發(fā)布公共組件） | mvn source:jar（發(fā)布到遠(yuǎn)程倉庫時(shí)，通常需搭配 jar:jar 一起執(zhí)行） |
| mvn javadoc:javadoc | 生成 JavaDoc 文檔，方便團(tuán)隊(duì)查閱接口說明 | mvn javadoc:javadoc（輸出到 target/site/apidocs 目錄，可部署到服務(wù)器供團(tuán)隊(duì)查看） |
| mvn assembly:single | 自定義打包（含依賴、配置文件、腳本等），生成 zip/tar 等格式 | mvn assembly:single（需在 pom.xml 中配置 assembly.xml，定義打包規(guī)則） |
| mvn shade:shade | 生成可執(zhí)行 Uber JAR（含所有依賴），可直接運(yùn)行，避免依賴缺失 | mvn shade:shade（可重命名依賴包名，解決依賴沖突，適合獨(dú)立運(yùn)行的項(xiàng)目） |
五、項(xiàng)目信息與輔助命令
日常開發(fā)中，經(jīng)常需要查看項(xiàng)目配置、創(chuàng)建新項(xiàng)目、修改版本等，以下命令可快速完成這些輔助操作，提升開發(fā)效率。
| 命令 | 作用 | 示例 |
|---|---|---|
| mvn help:effective-pom | 查看最終生效 POM（含繼承、默認(rèn)配置、profile 激活后的配置） | mvn help:effective-pom（排查 POM 配置問題，如依賴?yán)^承、profile 生效情況） |
| mvn help:effective-settings | 查看最終生效的 settings.xml 配置（含全局配置、鏡像、倉庫等） | mvn help:effective-settings（排查鏡像、倉庫配置問題，如依賴下載失?。?/td> |
| mvn help:describe | 查看插件/目標(biāo)詳情，了解插件參數(shù)、作用 | mvn help:describe -Dplugin=dependency -Ddetail（查看 dependency 插件所有目標(biāo)和參數(shù)） |
| mvn archetype:generate | 從模板快速創(chuàng)建 Maven 項(xiàng)目，避免手動(dòng)配置項(xiàng)目結(jié)構(gòu) | mvn archetype:generate -DgroupId=com.demo -DartifactId=demo-app -DarchetypeArtifactId=maven-archetype-quickstart（創(chuàng)建普通 Java 項(xiàng)目） |
| mvn versions:set | 批量修改項(xiàng)目版本（含父項(xiàng)目、子模塊），避免手動(dòng)修改 | mvn versions:set -DnewVersion=1.0.1（修改后用 versions:commit 確認(rèn)，versions:revert 回滾） |
| mvn scm:commit/scm:tag | 代碼提交、打標(biāo)簽（關(guān)聯(lián)版本控制工具，如 Git） | 提交：mvn scm:commit -Dmessage=“fix bug”；打標(biāo)簽：mvn scm:tag -Dtag=v1.0（發(fā)布版本時(shí)打標(biāo)簽，方便回溯） |
六、常用參數(shù)速記
以下參數(shù)可搭配任意 Maven 命令使用，用于控制構(gòu)建行為、加速構(gòu)建、排查問題，是日常開發(fā)的“小技巧”。
| 參數(shù) | 作用 | 使用示例 |
|---|---|---|
| -U | 強(qiáng)制更新快照依賴（snapshot 版本），解決快照依賴不更新問題 | mvn clean install -U |
| -o | 離線模式（不聯(lián)網(wǎng)），僅使用本地倉庫依賴，適合網(wǎng)絡(luò)不佳時(shí) | mvn clean package -o |
| -X | 輸出調(diào)試日志（詳細(xì)日志），排查構(gòu)建失敗、依賴沖突等問題 | mvn compile -X（日志較多，可輸出到文件查看） |
| -P[環(huán)境名] | 激活指定環(huán)境的 profile 配置（如 dev、test、prod），切換環(huán)境配置 | mvn clean package -Pdev（激活 dev 環(huán)境，使用 dev 環(huán)境的配置） |
| -T 4 | 并發(fā)構(gòu)建（4 線程），加速多模塊項(xiàng)目構(gòu)建，節(jié)省時(shí)間 | mvn -T 4C clean install（4C 表示按 CPU 核心數(shù)4倍配置線程） |
| -Dfile.encoding=UTF-8 | 指定編碼格式，避免中文亂碼（如編譯、打包時(shí)中文注釋亂碼） | mvn compile -Dfile.encoding=UTF-8 |
| -s | 指定自定義 settings.xml 文件路徑，替代默認(rèn)配置，適配多環(huán)境配置需求 | mvn clean install -s D:\maven\conf\settings-dev.xml（指定開發(fā)環(huán)境配置文件） |
七、高頻萬能命令
整理了7個(gè)日常開發(fā)最高頻的命令組合，無需記憶，直接復(fù)制執(zhí)行，覆蓋構(gòu)建、依賴排查、打包等核心場景：
# 1. 日常開發(fā)構(gòu)建（跳過測試，加速） mvn clean install -DskipTests # 2. 依賴沖突排查（快速查看依賴樹，定位沖突依賴） mvn dependency:tree # 3. 清理本地依賴（只刪不下載，最常用） mvn dependency:purge-local-repository -DreResolve=false # 4. 精確清理指定依賴 + 重新構(gòu)建（精準(zhǔn)解決單個(gè)依賴問題） mvn dependency:purge-local-repository -DmanualInclude="com.alibaba:fastjson" -DreResolve=false clean install # 5. 生成可執(zhí)行 Uber JAR（含所有依賴，可直接運(yùn)行） mvn clean package shade:shade -DskipTests # 6. 強(qiáng)制更新快照依賴 + 構(gòu)建（依賴快照版本不更新時(shí)） mvn clean install -U -DskipTests # 7. 只打包不安裝（供部署，無需安裝到本地倉庫） mvn clean package -DskipTests
總結(jié)
本文整理了 Maven 全場景常用命令，涵蓋核心生命周期、依賴管理、測試打包、項(xiàng)目輔助等模塊，重點(diǎn)補(bǔ)充了依賴清理的高級(jí)參數(shù)，所有命令均提供可直接復(fù)制的示例，適配 Java 后端高頻開發(fā)場景。熟練掌握這些命令，能大幅提升開發(fā)效率，避免因命令不熟悉導(dǎo)致的構(gòu)建問題。建議收藏本文，日常開發(fā)中快速檢索使用，也可轉(zhuǎn)發(fā)給團(tuán)隊(duì)同事，共同提升開發(fā)效率。
以上就是Maven中常用命令完整版速查表(2026年最新)的詳細(xì)內(nèi)容，更多關(guān)于Maven常用命令的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
SpringBoot連接PostgreSQL+MybatisPlus入門案例(代碼詳解)
這篇文章主要介紹了SpringBoot連接PostgreSQL+MybatisPlus入門案例,本文通過實(shí)例代碼圖文相結(jié)合給大家介紹的非常詳細(xì),感興趣的朋友跟隨小編一起看看吧2024-07-07
這篇文章主要為大家介紹了Flink ExecutionGraph生成源碼解析，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2022-12-12
Java多線程和并發(fā)基礎(chǔ)面試題（問答形式）
多線程和并發(fā)問題是Java技術(shù)面試中面試官比較喜歡問的問題之一。在這里，從面試的角度列出了大部分重要的問題，感興趣的小伙伴們可以參考一下2016-06-06
這篇文章主要介紹了如何解決無法獲取到Nacos配置中心的配置問題,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2025-06-06
這篇文章主要通過實(shí)例解析Java中的構(gòu)造器初始化，代碼很簡單，敘述很明確，需要的朋友可以了解下。2017-09-09
這篇文章主要介紹了IDEA中sout快捷鍵無效問題,在類文件中進(jìn)行操作會(huì)造成sout快捷命令無法自動(dòng)生成，比如操作了import引入其它包之后，本文給大家分享解決方法，感興趣的朋友一起看看吧2022-07-07
java評(píng)論、回復(fù)功能設(shè)計(jì)與實(shí)現(xiàn)方法
很多項(xiàng)目或者系統(tǒng)都有評(píng)論或者回復(fù)的需求,但評(píng)論回復(fù)的實(shí)現(xiàn)往往都比較復(fù)雜,也不好實(shí)現(xiàn),下面這篇文章主要給大家介紹了關(guān)于java評(píng)論、回復(fù)功能設(shè)計(jì)與實(shí)現(xiàn)的相關(guān)資料,需要的朋友可以參考下2022-06-06
這篇文章主要介紹了Java中Thread 和Runnable的區(qū)別，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-03-03
java后臺(tái)驗(yàn)證碼生成的實(shí)現(xiàn)方法
在我們使用進(jìn)行系統(tǒng)開發(fā)時(shí),為了提高系統(tǒng)的安全性,在登錄的時(shí)候多數(shù)人都會(huì)要求輸入驗(yàn)證，本文介紹了java后臺(tái)驗(yàn)證碼生成的實(shí)現(xiàn)方法，感興趣的一起來了解一下2021-05-05
這篇文章主要為大家詳細(xì)介紹了Java實(shí)現(xiàn)簡單的抽牌游戲，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2020-04-04