Configuración del entorno de desarrollo Java

Un JDK por sí solo es suficiente para compilar y ejecutar Java desde una terminal, pero para cualquier proyecto más grande que un puñado de archivos querrás un entorno de desarrollo integrado (IDE). Un IDE te ofrece autocompletado, refactorización, un depurador integrado y un modelo de proyecto que entiende la estructura de paquetes de Java.

Este capítulo compara los principales IDEs, explica una configuración recomendada y muestra cómo se organiza en disco un proyecto Java típico.

Elegir un IDE

Los tres IDEs de Java más populares son gratuitos para uso individual:

• IntelliJ IDEA Community Edition — el IDE de Java de JetBrains. La edición Community gratuita es más que suficiente para la mayoría de los proyectos de aprendizaje y muchos proyectos en producción; la edición Ultimate de pago añade soporte para frameworks como Spring y Jakarta EE. Recomendado para este libro.
• Eclipse IDE — el longevo IDE de código abierto, popular en grandes empresas.
• VS Code con el Extension Pack for Java — más ligero que IntelliJ o Eclipse, una buena opción si ya usas VS Code para otros lenguajes.

También puedes seguir el libro con un editor de texto simple (Vim, Sublime, Notepad) y usar los comandos javac y java directamente — los primeros capítulos muestran ambos estilos.

IntelliJ IDEA: configuración recomendada

Si no tienes preferencia, instala IntelliJ IDEA Community Edition.

1. Descárgalo desde jetbrains.com/idea y ejecuta el instalador.
2. Lanza IntelliJ y abre el diálogo New Project.
3. Selecciona Java y luego elige el JDK que instalaste en el capítulo anterior en el menú desplegable JDK (IntelliJ suele detectarlo automáticamente; si no lo hace, haz clic en Download JDK o Add JDK).
4. Elige Maven o Gradle como sistema de construcción si lo deseas, o IntelliJ para un proyecto de aprendizaje simple.
5. Haz clic en Create.

IntelliJ abrirá el nuevo proyecto, lo indexará y colocará el cursor dentro de un archivo Main.java vacío. Presiona Shift+F10 (Windows/Linux) o Control+R (macOS) para ejecutarlo.

VS Code

1. Instala VS Code.
2. Abre la barra lateral de Extensions y busca Extension Pack for Java (publicado por Microsoft).
3. Instálalo. El paquete incluye el servidor de lenguaje Java, el depurador, soporte para Maven y algunas extensiones relacionadas.
4. Abre una carpeta que contenga un archivo .java. VS Code detectará el JDK y ofrecerá ejecutar o depurar el programa desde los iconos del margen.

Si VS Code no puede encontrar tu JDK, establece la configuración java.jdt.ls.java.home a la raíz de instalación del JDK (el directorio que contiene bin/javac).

Eclipse

1. Descarga el paquete Eclipse IDE for Java Developers desde eclipse.org.
2. Descomprime y lanza.
3. Usa File → New → Java Project, asígnale un nombre y acepta el JDK predeterminado. Eclipse crea una carpeta src/ donde vivirán tus archivos .java.

Estructura del proyecto

La mayoría de los proyectos Java siguen una convención popularizada por Maven y adoptada por Gradle:

my-project/
├── pom.xml               # Maven build file (or build.gradle for Gradle)
├── src/
│   ├── main/
│   │   ├── java/         # production source files
│   │   │   └── com/example/MyApp.java
│   │   └── resources/    # config files, templates, properties
│   └── test/
│       ├── java/         # test source files
│       │   └── com/example/MyAppTest.java
│       └── resources/    # test fixtures
└── target/               # compiled output (gitignored)

El directorio src/main/java refleja la jerarquía de paquetes: una clase declarada como package com.example; vive en src/main/java/com/example/. Esto no es solo una convención — el compilador de Java se niega a encontrar una clase cuya declaración package no coincide con la ruta de su carpeta, por lo que la estructura de directorios y los nombres de paquetes deben coincidir exactamente. Sigue esta estructura y todas las herramientas de Java sabrán dónde encontrar tu código.

Para los primeros capítulos de este libro no necesitas nada de esto — un único archivo .java en cualquier carpeta es suficiente para comenzar.

Configurar JAVA_HOME y el PATH

Si tu IDE puede encontrar java y javac desde los menús, no necesitas tocar las variables de entorno. Pero en el momento en que cambias a la terminal — o usas Maven, Gradle, Spring Boot o cualquier herramienta de línea de comandos — estas necesitan que JAVA_HOME esté configurado.

JAVA_HOME es una variable de entorno que apunta a la raíz de tu instalación de JDK (la carpeta que contiene bin/, lib/, etc.). Las herramientas de construcción la leen para localizar el compilador y la biblioteca estándar, por lo que un JAVA_HOME ausente o incorrecto es la razón más común por la que mvn o gradle falla justo después de la instalación.

Verifica tu configuración desde una terminal:

java -version    # prints the runtime version, e.g. "openjdk 21.0.2"
javac -version   # prints the compiler version; should match the above
echo $JAVA_HOME  # on Windows: echo %JAVA_HOME%

Si java -version y javac -version reportan versiones diferentes, tu PATH y JAVA_HOME apuntan a JDKs distintos — corrígelo antes de compilar cualquier cosa.

Consulta Cómo instalar Java (JDK) para ver fragmentos específicos de cada plataforma, o usa un gestor de versiones como SDKMAN! que configura JAVA_HOME por shell automáticamente.

Atajos de teclado útiles

Los pocos atajos que usarás constantemente en IntelliJ:

• Run — Shift+F10 (Win/Linux) / Control+R (macOS)
• Debug — Shift+F9 / Control+D
• Format file — Ctrl+Alt+L / Cmd+Option+L
• Quick fix — Alt+Enter / Option+Return
• Find anywhere — Shift Shift (doble toque)
• Rename symbol — Shift+F6

VS Code y Eclipse tienen equivalentes en sus respectivos menús Keymap.

Qué sigue

Estás listo para escribir código. El Programa Java Hello World explica un primer programa completo línea por línea, y Cómo compilar y ejecutar un programa Java muestra lo que ocurre internamente cuando tu IDE hace clic en Run.

Práctica