Creación de tu primer proyecto en IntelliJ IDEA

1. Creación paso a paso de un proyecto nuevo

Un proyecto en IntelliJ IDEA — no es solo una carpeta con archivos, sino un contenedor completo en el que la IDE guarda todo lo relacionado con tu futura aplicación. En un proyecto se incluyen:

• código fuente (archivos con extensión .java);
• configuración del proyecto (por ejemplo, qué versión de Java usar);
• bibliotecas externas (si hacen falta);
• archivos y recursos auxiliares.

Dentro del proyecto suele haber una carpeta src: es el lugar principal para tus archivos Java. Todo lo que no pertenece al código se guarda aparte y no estorba al trabajo.

Iniciamos IntelliJ IDEA

En la pantalla de inicio, haz clic en el gran botón azul New Project.

Configuración de los parámetros del proyecto

Repasemos los campos principales de arriba abajo:

• Name: el nombre de tu proyecto. Este nombre también se usará para crear la carpeta en el disco.
• Location: la ruta donde se almacenará el proyecto en tu equipo. Por defecto IDEA propone su carpeta IdeaProjects. Lo dejamos como está.
• Create Git repository: permite inicializar de inmediato el sistema de control de versiones Git para el proyecto. En esta etapa, para no complicar las cosas, deja esta casilla sin marcar.
• Build system: el sistema de build es una herramienta que automatiza la compilación del código, la gestión de dependencias y la creación de la aplicación lista para usar:
  • IntelliJ: sistema de build integrado de IDEA. Nuestra elección.
  • Maven/Gradle: sistemas de build potentes e independientes; el 99% de los proyectos reales usa uno de ellos.
• Add sample code: IDEA creará automáticamente una estructura básica del proyecto y una clase con el método main.

Instalación del JDK desde IntelliJ IDEA

Hemos llegado al momento de instalar el JDK.

• Como aún no lo hemos instalado, la lista estará vacía. Nuestra tarea es descargarlo directamente desde aquí.

1. Haz clic en la lista desplegable y elige la opción Download JDK...

2. Se abrirá una ventana pequeña:

• Version: selección de la versión de Java. Nuestro curso admite la versión 25.
• Vendor: proveedor de la distribución. Como acordamos antes, elegimos Amazon Corretto.
• Location: ruta donde IDEA descargará e instalará este JDK. Puedes dejar el valor por defecto.

3. Haz clic en el botón Select.

Ya están hechos todos los ajustes. Pulsa Create.

IntelliJ IDEA empezará a descargar el JDK seleccionado y luego creará la estructura del proyecto y abrirá la ventana principal del editor. Habrá que esperar un par de minutos.

En el primer inicio puedes ver en la esquina inferior derecha una notificación de IDEA que te propone ajustar tu antivirus, por ejemplo: «Microsoft Defender may affect IDE performance». Pulsa sin miedo el botón Exclude folders. IntelliJ IDEA añadirá automáticamente a la lista de exclusiones de tu antivirus la carpeta del proyecto y sus carpetas de sistema.

Al iniciar el programa por primera vez, verás un banner informando sobre la activación del período de prueba gratuito de Ultimate. Es la bienvenida estándar en la nueva versión unificada de IntelliJ IDEA.

Esta notificación solo confirma que ahora tienes acceso temporal a Ultimate, pero para nuestro curso es un complemento opcional.

2. Breve recorrido por IDEA

Hemos creado un proyecto nuevo. Veamos qué tenemos delante.

1. Project: la ventana principal para navegar por la estructura del proyecto.

2. Archivo actualmente abierto: Main.java

3. Botones para Run ▶ (ejecución) y Debug (depuración) de la aplicación

4. Menú lateral

• Services la pestaña se usa para gestionar servicios externos; en esta etapa inicial no la necesitarás.
• Terminal es la línea de comandos (consola) de tu sistema operativo (Windows, macOS, Linux), integrada directamente en la IDE.
• Problems el panel muestra los errores de compilación y advertencias mientras escribes código. IDEA analiza tu código al vuelo y subraya los puntos problemáticos, a menudo ofreciendo correcciones automáticas.
• Git icono con forma de diagrama ramificado. Este panel está destinado a trabajar con el sistema de control de versiones Git.

3. Estructura del proyecto

Ahora miremos con más detalle la ventana de estructura del proyecto a la izquierda. IntelliJ IDEA ha creado por nosotros varios archivos y carpetas importantes.

• .idea - es una carpeta de servicio de IntelliJ IDEA. En ella se guardan ajustes específicos de este proyecto.
  No debes modificar esta carpeta manualmente ni enviarla a otros desarrolladores. Es individual para cada usuario.
• src - la carpeta más importante de cualquier proyecto Java. El nombre es la abreviatura de «sources» (fuentes). Aquí estará todo tu código.
  • Main.java como marcamos la casilla «Add sample code», IDEA creó este archivo por nosotros. Es una clase Java con el «punto de entrada» en la aplicación — el método public static void main(String[] args). A partir de él comienza la ejecución de cualquier programa Java.
• .gitignore - es un archivo de configuración para el sistema de control de versiones Git.
• External Libraries - no es una carpeta real, sino una representación virtual de todas las bibliotecas externas conectadas al proyecto. Ahora mismo hay solo una, pero la más importante — nuestro JDK.

4. Ejecución del programa

Lo más agradable es ejecutar el programa y ver el resultado de tu trabajo (y no solo errores).

En la parte superior de la ventana, pulsa el botón Run ▶. A su izquierda aparece el nombre del archivo que se ejecutará (en nuestro caso, Current File):

Alternativa: clic derecho sobre el archivo ▶ Run Run 'Main.main()'.

Verás el resultado de la ejecución del programa

Comando de ejecución (en rojo) — es el comando que IntelliJ IDEA ha formado y ha pasado al sistema operativo para iniciar el programa.

Es una llamada directa al ejecutable java.exe de ese mismo JDK que descargamos. Este archivo inicia la Máquina Virtual de Java (JVM). El resto de la línea después de java.exe son parámetros de servicio.

Salida del programa (en azul): ese es el resultado útil del funcionamiento de tu código.

Código de salida (en verde) Process finished with exit code 0. Este mensaje es el informe final de cómo terminó el programa.

• Por convención, exit code 0 significa que el programa ejecutó todas sus instrucciones de principio a fin y terminó normalmente, sin errores.
• Cualquier otro código indica que durante la ejecución se produjo un error.

Presta siempre atención a esta línea. Es tu principal indicador de si tu programa «se ha caído» o ha finalizado correctamente.

Además, después de la primera ejecución, en la estructura del proyecto a la izquierda apareció una nueva carpeta out. En ella se encuentran los archivos compilados .class: el bytecode que ejecuta la JVM.

¡Enhorabuena! Acabas de escribir y ejecutar tu primer programa en Java en una IDE profesional.

Cómo funciona la ejecución del programa en IDEA

Cuando pulsas Run, sucede lo siguiente:

1. IDEA compila tu código — convierte .java en .class (bytecode para la JVM).
2. Se inicia la JVM — la máquina virtual de Java empieza la ejecución del programa desde el método main.
3. Se muestra el resultado — todo lo que se imprime mediante System.out.println aparece en la consola.

Toda esta magia sucede en un par de clics — no hace falta invocar el compilador manualmente ni buscar dónde se guardó el archivo.

5. IntelliJ IDEA keyboard shortcuts

IntelliJ IDEA tiene atajos de teclado para la mayoría de los comandos relacionados con edición, navegación, refactorización, depuración y otras tareas. Memorizar estas teclas rápidas te ayudará a trabajar con más productividad sin apartar las manos del teclado.

Puedes consultar las combinaciones en la documentación de JetBrains, con la posibilidad de elegir el sistema operativo.

O verlas en la propia IDEA. Menu-Help-Keyboard shortcuts PDF.

6. Errores al crear el primer proyecto

Has creado un archivo Java fuera de la carpeta src

En el mundo de Java existe una regla de hierro: la carpeta src — es la raíz de la que «crecen» todas las fuentes de tu proyecto. El entorno de desarrollo y los sistemas de build esperan encontrar el código precisamente allí.

Discordancia entre el nombre de la clase y el del archivo
El archivo debe llamarse igual que la clase (¡respetando las mayúsculas y minúsculas!). Por ejemplo, Main.java para la clase Main. Si llamas al archivo main.java (con minúscula), el compilador se molestará.

Falta el método main o está mal escrito
El método debe ser exactamente public static void main(String[] args). Con un solo error tipográfico, el programa no se ejecutará.

No se ha seleccionado un JDK para el proyecto
Si al crear el proyecto no se selecciona el JDK o se elige una ruta incorrecta, IDEA no podrá compilar el proyecto. Comprueba la configuración en File → Project Structure → Project SDK.

Espacios y cirílico en la ruta
Aunque los sistemas modernos son mucho más tolerantes, la regla de oro sigue vigente: las rutas de los proyectos y del JDK no deben contener caracteres cirílicos, espacios ni símbolos especiales. Es mejor usar solo letras latinas y guiones bajos.

Ejecución de la clase equivocada
Si tienes varias clases con el método main, asegúrate de ejecutar el archivo correcto (clic derecho → ▶ Run).