Commandes courantes Maven

Les commandes Maven suivent le modèle suivant :

mvn [选项] [生命周期阶段] [目标]

Vérifier la version de Maven

Exemple

mvn -v

Cette commande affiche la version de Maven installée, la version de Java et d'autres informations.


Commandes du cycle de vie Maven

Maven est basé sur le concept de cycles de vie de build, comprenant trois cycles de vie principaux :

  1. clean : nettoyer le projet
  2. default (build) : construire le projet
  3. site : générer la documentation du projet

Nettoyer le projet

Exemple

mvn clean

Cette commande supprimera letargetrépertoire, c'est-à-dire supprimer tous les fichiers générés par le build.

Compiler le projet

Exemple

mvn compile

Compiler le code source. Les fichiers de classe compilés seront placés dans letarget/classesrépertoire.

Exécuter les tests

Exemple

mvn test

Exécuter tous les cas de test du projet.

Packager le projet

Exemple

mvn package

Packager le projet selon le type d'empaquetage (tel que jar, war) spécifié dans le fichier POM.

Installer dans le dépôt local

Exemple

mvn install

Construire et installer le projet dans le dépôt Maven local afin qu'il soit utilisé comme dépendance par d'autres projets.

Déployer vers le dépôt distant

Exemple

mvn deploy

Copier le paquet final du projet dans le dépôt distant pour qu'il soit utilisé par d'autres développeurs et projets.


Commandes de gestion des dépendances

Afficher l'arborescence des dépendances du projet

Exemple

mvn dependency:tree

Afficher l'arborescence des dépendances du projet, ce qui aide à analyser les relations de dépendance et à résoudre les conflits de dépendances.

Télécharger le code source

Exemple

mvn dependency:sources

Télécharger le code source des dépendances du projet.

Analyser les dépendances

Exemple

mvn dependency:analyze

Analyser les dépendances qui sont utilisées mais non déclarées, ainsi que les dépendances qui sont déclarées mais non utilisées.


Commandes de création de projet

Créer un projet simple

Exemple

mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

Créer un projet Java simple à l'aide du système d'archétypes Maven.

Créer un projet Web

Exemple

mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-web-app -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false

Créer un projet d'application Web simple.


Autres commandes utiles

Ignorer les tests

Exemple

mvn install -DskipTests

Construire le projet et l'installer dans le dépôt local, mais ignorer la phase de test.

Exécuter des tests spécifiques

Exemple

mvn test -Dtest=TestClassName

Exécuter uniquement la classe de test spécifiée.

Exemple

mvn test -Dtest=TestClassName#testMethodName

Exécuter uniquement une méthode de test spécifique dans la classe de test spécifiée.

Mettre à jour les dépendances

Exemple

mvn versions:display-dependency-updates

Vérifier quelles dépendances du projet ont des versions plus récentes disponibles.

Générer la documentation du site

Exemple

mvn site

Générer la documentation du site du projet, y compris divers rapports.

Exécuter une phase spécifique

Exemple

mvn clean package

Exécuter d'abord le cycle de vie clean, puis exécuter le cycle de vie par défaut jusqu'à la phase package.


Combiner les commandes Maven

Les commandes Maven peuvent être combinées pour améliorer l'efficacité :

Exemple

mvn clean install

Nettoyer d'abord le projet, puis compiler, tester et installer dans le dépôt local.

Exemple

mvn clean package -DskipTests

Nettoyer le projet, packager mais ne pas exécuter les tests.


Dépannage des problèmes courants

Forcer la mise à jour des dépendances snapshot

Exemple

mvn clean install -U

-ULe paramètre force Maven à rechercher les versions mises à jour des dépendances dans les dépôts distants.

Mode hors ligne

Exemple

mvn -o package

-oLe paramètre fait fonctionner Maven en mode hors ligne, en utilisant uniquement les dépendances du dépôt local.

Mode débogage

Exemple

mvn -X clean install

-XLe paramètre active la sortie de débogage, affichant des informations détaillées sur l'exécution.


Commandes de build de base

CommandeObjectifPhase du cycle de vie exécutée
mvn cleanDeletetarget/répertoireclean
mvn validateVérifier que le projet est correctvalidate
mvn compileCompiler le code source principalcompile
mvn test-compileCompiler le code de testtest-compile
mvn testExécuter les tests unitairestest
mvn packagePackager le projetpackage
mvn verifyExécuter les tests d'intégrationverify
mvn installInstaller dans le dépôt localinstall
mvn deployDéployer vers le dépôt distantdeploy

Flux de travail de développement typique :

mvn clean compile test package

Commandes de gestion des dépendances

CommandeObjectif
mvn dependency:treeAfficher l'arbre des dépendances
mvn dependency:analyzeAnalyser les problèmes de dépendances
mvn dependency:copy-dependenciesCopier les dépendances dans le répertoire
mvn dependency:purge-local-repositoryVider le cache local des dépendances
mvn versions:display-dependency-updatesVérifier les mises à jour des dépendances
# 查看依赖树
mvn dependency:tree

# 检查可用更新
mvn versions:display-dependency-updates

Commandes relatives aux plugins

CommandeObjectif
mvn help:describe -Dplugin=插件名Afficher les informations sur le plugin
mvn help:effective-pomAfficher le POM effectif
mvn 插件前缀:目标Exécuter directement l'objectif du plugin
# 查看compiler插件信息
mvn help:describe -Dplugin=compiler

# 直接运行compiler插件的compile目标
mvn compiler:compile

Commandes relatives aux tests

CommandeObjectif
mvn testExécuter tous les tests
mvn -Dtest=测试类名 testExécuter la classe de test spécifiée
mvn -Dtest=测试类名#方法名 testExécuter la méthode de test spécifiée
mvn -DskipTests=true packageIgnorer les tests
# 只运行UserServiceTest类
mvn -Dtest=UserServiceTest test

# 只运行UserServiceTest中的testCreate方法
mvn -Dtest=UserServiceTest#testCreate test

Commandes de projet multi-module

CommandeObjectif
mvn -pl 模块名 命令Exécuter la commande sur le module spécifié
mvn -am -pl 模块名 命令Exécuter la commande et traiter les modules dépendants
mvn -rf 模块名 命令Continuer l'exécution à partir du module spécifié
# 只编译service模块
mvn -pl service compile

# 编译web模块及其依赖的模块
mvn -am -pl web compile

Utilisation avancée

CommandeObjectif
mvn -T 4 installConstruire en parallèle avec 4 threads
mvn -o packageExécuter en mode hors ligne
mvn -X clean installActiver la sortie de débogage
mvn -U clean installForcer la mise à jour des dépendances snapshot
mvn release:preparePréparer la publication du projet
mvn release:performEffectuer la publication du projet
# 并行构建(4线程)
mvn -T 4 clean install

# 强制更新snapshot依赖
mvn -U clean install

Combinaisons de commandes courantes

Commande combinéeObjectif
mvn clean installNettoyer et réinstaller
mvn clean package -DskipTestsNettoyer, empaqueter et ignorer les tests
mvn clean testNettoyer et exécuter les tests
mvn clean deployNettoyer et déployer

Astuces pratiques

Afficher rapidement les informations du projet :

mvn help:effective-pom
mvn help:describe -Dcmd=compile

Déboguer les problèmes de build :

mvn -X clean install

Ignorer les vérifications :

mvn install -Dcheckstyle.skip=true -Dpmd.skip=true

Spécifier le profil :

mvn install -P production

Afficher le temps de build :

mvn install --batch-mode | grep "Total time"
Autres extensions