Comandos comunes de Maven

Los comandos de Maven siguen el siguiente patrón:

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

Verificar la versión de Maven

Ejemplo

mvn -v

Este comando muestra la versión de Maven instalada, la versión de Java y otra información.


Comandos del ciclo de vida de Maven

Maven se basa en el concepto de ciclo de vida de construcción e incluye tres ciclos de vida principales:

  1. clean: limpia el proyecto
  2. default (build): construcción del proyecto
  3. site: genera la documentación del proyecto

Limpiar el proyecto

Ejemplo

mvn clean

Este comando elimina eltargetdirectorio, es decir, elimina todos los archivos generados por la construcción.

Compilar el proyecto

Ejemplo

mvn compile

Compila el código fuente; los archivos class compilados se colocarán en eltarget/classesdirectorio.

Ejecutar pruebas

Ejemplo

mvn test

Ejecuta todos los casos de prueba del proyecto.

Empaquetar el proyecto

Ejemplo

mvn package

Empaqueta el proyecto según el tipo de empaquetado especificado en el archivo POM (por ejemplo, jar, war).

Instalar en el repositorio local

Ejemplo

mvn install

Construye e instala el proyecto en el repositorio local de Maven para que otros proyectos puedan usarlo como dependencia.

Desplegar en el repositorio remoto

Ejemplo

mvn deploy

Copia el paquete final del proyecto al repositorio remoto para que lo usen otros desarrolladores y proyectos.


Comandos de gestión de dependencias

Ver el árbol de dependencias del proyecto

Ejemplo

mvn dependency:tree

Muestra el árbol de dependencias del proyecto, lo que ayuda a analizar las relaciones de dependencia y resolver conflictos de dependencias.

Descargar el código fuente

Ejemplo

mvn dependency:sources

Descarga el código fuente de las dependencias del proyecto.

Analizar dependencias

Ejemplo

mvn dependency:analyze

Analiza las dependencias que se usan en el proyecto pero no se declaran, así como las que se declaran pero no se usan.


Comandos de creación de proyectos

Crear un proyecto simple

Ejemplo

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

Crea un proyecto Java simple utilizando el sistema de arquetipos de Maven.

Crear un proyecto web

Ejemplo

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

Crea un proyecto de aplicación web simple.


Otros comandos útiles

Omitir pruebas

Ejemplo

mvn install -DskipTests

Construye el proyecto y lo instala en el repositorio local, pero omite la fase de pruebas.

Ejecutar pruebas específicas

Ejemplo

mvn test -Dtest=TestClassName

Solo ejecuta la clase de prueba especificada.

Ejemplo

mvn test -Dtest=TestClassName#testMethodName

Solo ejecuta el método de prueba específico dentro de la clase de prueba especificada.

Actualizar dependencias

Ejemplo

mvn versions:display-dependency-updates

Comprueba qué dependencias del proyecto tienen versiones más recientes disponibles.

Generar documentación del sitio

Ejemplo

mvn site

Genera la documentación del sitio del proyecto, incluidos varios informes.

Ejecutar una fase específica

Ejemplo

mvn clean package

Primero ejecuta el ciclo de vida clean y luego el ciclo de vida default hasta la fase package.


Uso combinado de comandos de Maven

Los comandos de Maven se pueden combinar para aumentar la eficiencia:

Ejemplo

mvn clean install

Primero limpia el proyecto, luego compila, prueba e instala en el repositorio local.

Ejemplo

mvn clean package -DskipTests

Limpia el proyecto, empaqueta pero no ejecuta las pruebas.


Resolución de problemas comunes

Forzar la actualización de dependencias snapshot

Ejemplo

mvn clean install -U

-UEl parámetro obliga a Maven a comprobar en el repositorio remoto las versiones actualizadas de las dependencias.

Modo fuera de línea

Ejemplo

mvn -o package

-oEl parámetro hace que Maven se ejecute en modo fuera de línea, utilizando solo las dependencias del repositorio local.

Modo de depuración

Ejemplo

mvn -X clean install

-XEl parámetro habilita la salida de depuración y muestra información detallada de la ejecución.


Comandos básicos de construcción

ComandoDescripciónFase del ciclo de vida que ejecuta
mvn cleanEliminartarget/directorioclean
mvn validateVerifica si el proyecto es correctovalidate
mvn compileCompila el código fuente principalcompile
mvn test-compileCompila el código de pruebatest-compile
mvn testEjecuta pruebas unitariastest
mvn packageEmpaqueta el proyectopackage
mvn verifyEjecuta pruebas de integraciónverify
mvn installInstala en el repositorio localinstall
mvn deployDespliega en el repositorio remotodeploy

Flujo de desarrollo típico:

mvn clean compile test package

Comandos de gestión de dependencias

ComandoDescripción
mvn dependency:treeMuestra el árbol de dependencias
mvn dependency:analyzeAnaliza problemas de dependencias
mvn dependency:copy-dependenciesCopia las dependencias al directorio
mvn dependency:purge-local-repositoryLimpia la caché de dependencias local
mvn versions:display-dependency-updatesComprueba actualizaciones de dependencias
# 查看依赖树
mvn dependency:tree

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

Comandos relacionados con plugins

ComandoDescripción
mvn help:describe -Dplugin=插件名Ver información del plugin
mvn help:effective-pomVer el POM efectivo final
mvn 插件前缀:目标Ejecutar directamente el objetivo del plugin
# 查看compiler插件信息
mvn help:describe -Dplugin=compiler

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

Comandos relacionados con pruebas

ComandoDescripción
mvn testEjecutar todas las pruebas
mvn -Dtest=测试类名 testEjecutar la clase de prueba especificada
mvn -Dtest=测试类名#方法名 testEjecutar el método de prueba especificado
mvn -DskipTests=true packageOmitir pruebas
# 只运行UserServiceTest类
mvn -Dtest=UserServiceTest test

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

Comandos para proyectos multimódulo

ComandoDescripción
mvn -pl 模块名 命令Ejecutar el comando en el módulo especificado
mvn -am -pl 模块名 命令Ejecutar el comando y procesar los módulos dependientes
mvn -rf 模块名 命令Continuar la ejecución desde el módulo especificado
# 只编译service模块
mvn -pl service compile

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

Uso avanzado

ComandoDescripción
mvn -T 4 installConstruir en paralelo con 4 hilos
mvn -o packageEjecutar en modo fuera de línea
mvn -X clean installActivar la salida de depuración
mvn -U clean installForzar la actualización de dependencias snapshot
mvn release:preparePreparar la publicación del proyecto
mvn release:performEjecutar la publicación del proyecto
# 并行构建(4线程)
mvn -T 4 clean install

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

Combinaciones de comandos comunes

Comando combinadoDescripción
mvn clean installLimpiar y reinstalar
mvn clean package -DskipTestsLimpiar, empaquetar y omitir pruebas
mvn clean testLimpiar y ejecutar pruebas
mvn clean deployLimpiar y desplegar

Consejos útiles

Ver rápidamente la información del proyecto:

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

Depurar problemas de construcción:

mvn -X clean install

Omitir comprobaciones:

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

Especificar el perfil de configuración:

mvn install -P production

Ver el tiempo de construcción:

mvn install --batch-mode | grep "Total time"
Otras extensiones