23/01/1999
IntelliJ IDEA, un entorno de desarrollo integrado (IDE) popular para Java y otros lenguajes, ofrece una gestión flexible de librerías. Aprender a agregar librerías en IntelliJ IDEA es crucial para cualquier desarrollador que utiliza este IDE. Esta tutorial abarca diferentes métodos, desde añadir librerías manualmente hasta integrarlas a través de herramientas como Maven. Entender cómo gestionar las dependencias es clave para proyectos de cualquier tamaño.

Tipos de Librerías en IntelliJ IDEA
Antes de ver cómo agregar librerías en IntelliJ IDEA, es importante comprender los diferentes niveles en los que se pueden definir:
- Librerías Globales: Disponibles para todos los proyectos en el IDE. Son ideales para librerías que se utilizan en muchos proyectos.
- Librerías de Proyecto: Visibles para todos los módulos dentro de un proyecto específico. Útiles para librerías compartidas dentro de un mismo proyecto.
- Librerías de Módulo: Limitadas a un solo módulo. Se utilizan para dependencias específicas de un módulo en particular.
Métodos para Agregar Librerías
Agregar Librerías desde Archivos JAR
Este método es el más básico y se utiliza para agregar librerías en IntelliJ IDEA que ya tienes descargadas en tu sistema. Puedes añadir archivos JAR individuales o directorios que contengan varios JARs.
- Abre la estructura del proyecto: Ve a
File | Project Structure (Ctrl+Alt+Shift+S). - Selecciona el nivel de la librería: Elige
Global Librariespara una librería global,Librariespara una de proyecto oModules | Dependenciespara una de módulo. - Añade la librería: Haz clic en el botón
+y seleccionaJava. Navega hasta la ubicación de tu archivo JAR o directorio y selecciónalo. - Aplica los cambios: Haz clic en
Applyy luego enOKpara guardar los cambios.
Agregar Librerías desde Maven
Maven es un gestor de dependencias popular. Utilizar Maven para agregar librerías en IntelliJ IDEA simplifica enormemente el proceso y facilita la gestión de actualizaciones.
- Abre la estructura del proyecto:
File | Project Structure (Ctrl+Alt+Shift+S). - Selecciona el nivel de la librería: Elige
Global LibrariesoLibraries. - Añade la librería: Haz clic en el botón
+y seleccionaFrom Maven. - Especifica la dependencia: Introduce el
groupId,artifactIdyversionde la librería. IntelliJ IDEA buscará la librería en los repositorios de Maven. - Selecciona las dependencias transitivas: Decide si deseas descargar dependencias transitivas, archivos fuente (
sources) y Javadoc. - Aplica los cambios: Haz clic en
Applyy luego enOK.
Agregar Librerías desde un Archivo POM (Maven)
Si ya tienes un archivo pom.xml, IntelliJ IDEA puede importar las dependencias automáticamente.

- Abre el proyecto en IntelliJ IDEA.
- IntelliJ IDEA detectará el archivo
pom.xmly te ofrecerá importar las dependencias. Si no lo hace, puedes importarlas manualmente a través deFile | Project Structurey seleccionandoProject Settings | Modules. Añade la dependencia Maven.
Agregar una librería desde archivos dentro del proyecto
Si los archivos JAR se encuentran dentro de la estructura de tu proyecto, puedes añadirlos como librería directamente desde el explorador de proyectos.
- Selecciona los archivos JAR en la ventana de
Project(Alt+1). - Haz clic derecho y selecciona
Add as Library.
Gestión Avanzada de Librerías
Incluir Dependencias Transitivas Específicas
Cuando se agrega una librería que tiene dependencias transitivas, puedes especificar cuáles incluir o excluir.

- Abre la estructura del proyecto:
File | Project Structure (Ctrl+Alt+Shift+S). - Ve a
Modules | Dependencies. - Selecciona la librería Maven y haz clic en el icono de edición.
- Haz clic en
Edity luego enConfigurejunto aInclude transitive dependencies. - Selecciona las dependencias que deseas incluir.
Cambiar el Nivel de una Librería
Puedes mover una librería entre niveles (global, proyecto, módulo).
- Abre la estructura del proyecto:
File | Project Structure (Ctrl+Alt+Shift+S). - Localiza la librería.
- Haz clic derecho y selecciona
Move to Project LibrariesoMove to Global Libraries.
Copiar una Librería a un Nivel Inferior
Crea una copia de una librería en un nivel inferior (por ejemplo, copiar una librería de proyecto a un módulo).
- Abre la estructura del proyecto:
File | Project Structure (Ctrl+Alt+Shift+S). - Localiza la librería.
- Haz clic derecho y selecciona
Copy to Project LibrariesoAdd to Modules.
Excluir Elementos de una Librería
Para mejorar el rendimiento, puedes excluir temporalmente elementos de una librería.

- Abre la estructura del proyecto:
File | Project Structure (Ctrl+Alt+Shift+S). - Selecciona
LibrariesoModules | Dependencies. - Selecciona la librería y los elementos a excluir.
Configurar Repositorios Remotos Personalizados
Puedes añadir repositorios Maven personalizados además de los repositorios públicos.
- Abre la configuración:
Ctrl+Alt+S. - Ve a
Build, Execution, Deployment | Remote Jar Repositories. - Haz clic en
Addy especifica la URL del repositorio.
Configurar la Documentación de la Librería
Añadir la documentación de la librería facilita la comprensión del código.
- Descarga el Javadoc al agregar la librería desde Maven.
- Para añadir documentación manualmente, en la estructura del proyecto, selecciona la librería, haz clic en el icono de edición y especifica la URL de la documentación externa o la ruta al archivo de documentación.
Tabla Comparativa de Métodos para Agregar Librerías
| Método | Descripción | Ventajas | Desventajas |
|---|---|---|---|
| Archivos JAR | Agregar librerías manualmente desde archivos JAR. | Simple para librerías individuales. | Gestionar dependencias puede ser complejo. |
| Maven | Utilizar Maven para gestionar dependencias. | Gestiona dependencias automáticamente, fácil de actualizar. | Requiere conocimiento de Maven. |
| POM (Maven) | Importar dependencias desde un archivo POM. | Automatiza la importación de dependencias. | Requiere un archivo POM. |
Consultas Habituales
- ¿Cómo agrego la librería javax.servlet en IntelliJ? Dependiendo de si usas Maven o Gradle, agregarías la dependencia correspondiente en tu archivo
pom.xmlobuild.gradle. Si no usas un gestor de dependencias, deberás descargar el JAR manualmente y añadirlo como se describió anteriormente. - ¿Cómo soluciono el error "ClassNotFoundException"? Generalmente indica que la librería que contiene la clase no está correctamente agregada al proyecto. Verifica la configuración de las librerías en la estructura del proyecto.
- ¿Cómo actualizo una librería en IntelliJ? Si usas Maven o Gradle, simplemente actualiza la versión en el archivo de configuración de dependencias (
pom.xmlobuild.gradle) y sincroniza el proyecto.
Dominar la gestión de librerías en IntelliJ IDEA es esencial para el desarrollo eficiente. Recuerda elegir el método que mejor se adapte a tus necesidades y al tamaño de tu proyecto. La utilización de herramientas como Maven o Gradle es altamente recomendable para proyectos de mayor envergadura.
Si quieres conocer otros artículos parecidos a Agregar librerías en intellij idea puedes visitar la categoría Libros y Librerías.
