04/11/2010
IntelliJ IDEA, un entorno de desarrollo integrado (IDE) popular para Java, facilita la gestión de librerías. Aprender a agregar librerías Java en IntelliJ es fundamental para cualquier desarrollador. Este artículo proporciona una tutorial exhaustiva sobre cómo importar paquetes, gestionar dependencias y optimizar tus importaciones para un desarrollo eficiente.
Importando Paquetes en Java con IntelliJ
Auto-Importación
IntelliJ IDEA ofrece una función de auto-importación inteligente. Cuando utilizas una clase, método estático o campo estático sin importarlo previamente, el IDE muestra una sugerencia (tooltip) para añadir la importación faltante. Simplemente presiona Alt+Enter para aceptar la sugerencia. Si existen varias opciones de importación posibles, Alt+Enter mostrará una lista de sugerencias para que puedas seleccionar la correcta.
Para modificar el color de fondo de estas sugerencias, ve a Archivo > Ajustes > Editor > Esquema de Colores > General > Ventanas emergentes y sugerencias > Sugerencia de pregunta.
Configurando la Auto-Importación
Puedes configurar IntelliJ IDEA para que añada automáticamente las sentencias de importación si no hay opciones entre las que elegir. Para ello, accede a Archivo > Ajustes > Editor > General > Auto-Importación. Selecciona la casilla Añadir importaciones inequívocas sobre la marcha y aplica los cambios. Esto importará automáticamente las clases o métodos estáticos al pegar código.
Puedes ajustar el comportamiento al pegar código con las opciones: Pedir confirmación para cada inserción o Nunca insertar sentencias de importación manualmente.
Importar Paquetes en lugar de Clases Individuales
IntelliJ IDEA, por defecto, sugiere importar clases individuales. Puedes cambiarlo para importar paquetes completos. Ve a Archivo > Ajustes > Editor > Estilo de código > Java > Importaciones. Desactiva la casilla Usar importación de clase única y aplica los cambios.
Deshabilitar las Importaciones con comodín ()
Cuando IntelliJ IDEA importa un número determinado de clases del mismo paquete (5 por defecto), modifica las sentencias para importar el paquete entero. Para deshabilitar esto y siempre importar clases individuales, ve a Archivo > Ajustes > Editor > Estilo de código > Java. Asegúrate de que la opción Usar importación de clase única esté activada. En los campos Recuento de clases para usar importación con '' y Recuento de nombres para usar importación estática con '', especifica valores que superen el número de clases en un paquete y el número de nombres en una clase (por ejemplo, 999).
Para reemplazar una importación con comodín por importaciones de clases individuales en un archivo sin cambiar la configuración, coloca el cursor en la sentencia de importación, presiona Alt+Enter y selecciona Reemplazar con importaciones de clase única.
Deshabilitar la Auto-Importación
Para deshabilitar completamente la auto-importación, asegúrate de:

- Deshabilitar todas las sugerencias de importación.
- Deshabilitar la inserción automática de sentencias de importación.
Excluir Clases y Paquetes de la Auto-Importación
Puedes excluir entradas redundantes de la auto-importación para que la lista de sugerencias solo contenga elementos relevantes. Ve a Archivo > Ajustes > Editor > General > Auto-Importación. En la sección Excluir de la auto-importación y la finalización del código, haz clic en Alt+Insertar y especifica la clase o paquete que deseas excluir. Puedes elegir si excluir elementos del proyecto actual o de todos los proyectos (globalmente).
Optimizar Importaciones
La función Optimizar Importaciones elimina las importaciones no utilizadas y organiza las sentencias de importación en el archivo actual o en todos los archivos de un directorio. Puedes hacerlo desde Código > Optimizar Importaciones (Ctrl+Alt+O). También puedes optimizar las importaciones al guardar el archivo ( Archivo > Ajustes > Herramientas > Acciones al guardar ).
Añadir Archivos JAR a tu Proyecto
Para añadir librerías externas (usualmente en formato JAR), existen varias maneras:
Método 1: A través de las dependencias (Recomendado)
Utilizar un gestor de dependencias como Maven o Gradle es la forma más eficiente. Estos gestores descargan automáticamente las librerías necesarias y gestionan sus versiones. En IntelliJ, la configuración de Maven o Gradle se realiza en el archivo pom.xml(Maven) o build.gradle(Gradle). Añade las dependencias en estos archivos y IntelliJ las descargará y añadirá automáticamente al classpath.
Método 2: Añadiendo manualmente el JAR
Si no usas gestores de dependencias, puedes añadir manualmente el archivo JAR:
- En la ventana de Project , haz clic derecho en tu proyecto.
- Selecciona Open Module Settings (o Estructura del Módulo ).
- Ve a la pestaña Dependencias .
- Haz clic en el botón + y selecciona JARs or directories...
- Navega hasta la ubicación del archivo JAR y selecciónalo.
- Haz clic en Aceptar .
Ahora el archivo JAR se añadirá a la configuración del proyecto. Asegúrate de que la ruta sea correcta.
Consultas Habituales
| Pregunta | Respuesta |
|---|---|
| ¿Cómo agrego una librería externa a mi proyecto? | Utiliza un gestor de dependencias (Maven o Gradle) o añade el archivo JAR manualmente como se describe arriba. |
| ¿Qué pasa si tengo conflictos de versiones entre librerías? | Los gestores de dependencias como Maven o Gradle ayudan a resolver estos conflictos. |
| ¿Cómo elimino una librería de mi proyecto? | En la ventana Estructura del Módulo , pestaña Dependencias , selecciona la librería y haz clic en el botón - . |
Tabla Comparativa: Métodos de Añadir Librerías
| Método | Ventajas | Desventajas |
|---|---|---|
| Maven/Gradle | Automatizado, gestión de versiones, fácil mantenimiento. | Requiere conocimiento de Maven o Gradle. |
| Añadir JAR manualmente | Simple para proyectos pequeños. | Prone a errores, gestión de versiones manual, difícil mantenimiento para proyectos grandes. |
Recuerda que usar un gestor de dependencias es la mejor práctica para proyectos de cualquier tamaño, facilitando la gestión de dependencias y evitando problemas de versiones.
Si quieres conocer otros artículos parecidos a Agregar librerías java en intellij idea puedes visitar la categoría Libros y Librerías.
