Comandos comunes de Maven
Los comandos de Maven siguen el siguiente patrón:
mvn [选项] [生命周期阶段] [目标]
Verificar la versión de Maven
Ejemplo
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:
- clean: limpia el proyecto
- default (build): construcción del proyecto
- site: genera la documentación del proyecto
Limpiar el proyecto
Ejemplo
Este comando elimina eltargetdirectorio, es decir, elimina todos los archivos generados por la construcción.
Compilar el proyecto
Ejemplo
Compila el código fuente; los archivos class compilados se colocarán en eltarget/classesdirectorio.
Ejecutar pruebas
Ejemplo
Ejecuta todos los casos de prueba del proyecto.
Empaquetar el proyecto
Ejemplo
Empaqueta el proyecto según el tipo de empaquetado especificado en el archivo POM (por ejemplo, jar, war).
Instalar en el repositorio local
Ejemplo
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
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
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
Descarga el código fuente de las dependencias del proyecto.
Analizar dependencias
Ejemplo
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
Crea un proyecto Java simple utilizando el sistema de arquetipos de Maven.
Crear un proyecto web
Ejemplo
Crea un proyecto de aplicación web simple.
Otros comandos útiles
Omitir pruebas
Ejemplo
Construye el proyecto y lo instala en el repositorio local, pero omite la fase de pruebas.
Ejecutar pruebas específicas
Ejemplo
Solo ejecuta la clase de prueba especificada.
Ejemplo
Solo ejecuta el método de prueba específico dentro de la clase de prueba especificada.
Actualizar dependencias
Ejemplo
Comprueba qué dependencias del proyecto tienen versiones más recientes disponibles.
Generar documentación del sitio
Ejemplo
Genera la documentación del sitio del proyecto, incluidos varios informes.
Ejecutar una fase específica
Ejemplo
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
Primero limpia el proyecto, luego compila, prueba e instala en el repositorio local.
Ejemplo
Limpia el proyecto, empaqueta pero no ejecuta las pruebas.
Resolución de problemas comunes
Forzar la actualización de dependencias snapshot
Ejemplo
-UEl parámetro obliga a Maven a comprobar en el repositorio remoto las versiones actualizadas de las dependencias.
Modo fuera de línea
Ejemplo
-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
-XEl parámetro habilita la salida de depuración y muestra información detallada de la ejecución.
Comandos básicos de construcción
| Comando | Descripción | Fase del ciclo de vida que ejecuta |
|---|---|---|
mvn clean | Eliminartarget/directorio | clean |
mvn validate | Verifica si el proyecto es correcto | validate |
mvn compile | Compila el código fuente principal | compile |
mvn test-compile | Compila el código de prueba | test-compile |
mvn test | Ejecuta pruebas unitarias | test |
mvn package | Empaqueta el proyecto | package |
mvn verify | Ejecuta pruebas de integración | verify |
mvn install | Instala en el repositorio local | install |
mvn deploy | Despliega en el repositorio remoto | deploy |
Flujo de desarrollo típico:
mvn clean compile test package
Comandos de gestión de dependencias
| Comando | Descripción |
|---|---|
mvn dependency:tree | Muestra el árbol de dependencias |
mvn dependency:analyze | Analiza problemas de dependencias |
mvn dependency:copy-dependencies | Copia las dependencias al directorio |
mvn dependency:purge-local-repository | Limpia la caché de dependencias local |
mvn versions:display-dependency-updates | Comprueba actualizaciones de dependencias |
# 查看依赖树 mvn dependency:tree # 检查可用更新 mvn versions:display-dependency-updates
Comandos relacionados con plugins
| Comando | Descripción |
|---|---|
mvn help:describe -Dplugin=插件名 | Ver información del plugin |
mvn help:effective-pom | Ver 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
| Comando | Descripción |
|---|---|
mvn test | Ejecutar todas las pruebas |
mvn -Dtest=测试类名 test | Ejecutar la clase de prueba especificada |
mvn -Dtest=测试类名#方法名 test | Ejecutar el método de prueba especificado |
mvn -DskipTests=true package | Omitir pruebas |
# 只运行UserServiceTest类 mvn -Dtest=UserServiceTest test # 只运行UserServiceTest中的testCreate方法 mvn -Dtest=UserServiceTest#testCreate test
Comandos para proyectos multimódulo
| Comando | Descripció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
| Comando | Descripción |
|---|---|
mvn -T 4 install | Construir en paralelo con 4 hilos |
mvn -o package | Ejecutar en modo fuera de línea |
mvn -X clean install | Activar la salida de depuración |
mvn -U clean install | Forzar la actualización de dependencias snapshot |
mvn release:prepare | Preparar la publicación del proyecto |
mvn release:perform | Ejecutar la publicación del proyecto |
# 并行构建(4线程) mvn -T 4 clean install # 强制更新snapshot依赖 mvn -U clean install
Combinaciones de comandos comunes
| Comando combinado | Descripción |
|---|---|
mvn clean install | Limpiar y reinstalar |
mvn clean package -DskipTests | Limpiar, empaquetar y omitir pruebas |
mvn clean test | Limpiar y ejecutar pruebas |
mvn clean deploy | Limpiar 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