Saltar a contenido

Paso a paso (VSCode) para crear un proyecto Spring Boot + Thymeleaf (según tus imágenes)

Flujo basado en VSCode + Spring Initializr (extensión).
Las pantallas que muestras corresponden a las selecciones típicas del asistente.

0. Prerrequisitos rápidos (antes de empezar)

  • Tener instalado Java (JDK) en tu máquina (ideal: 17 o 21).
  • En VSCode, tener extensiones:
  • Extension Pack for Java (o al menos “Java”)
  • Spring Boot Extension Pack (incluye Spring Initializr)

1. VSCode sin carpeta abierta

Paso 1. Seleccionar "Create Java Project"

  1. Abre VSCode.
  2. Te aparece el panel del Explorador con el mensaje “No hay ninguna carpeta abierta”.
  3. En este punto no es obligatorio abrir carpeta aún, porque el asistente de Spring Initializr te va a pedir dónde guardar el proyecto (en pasos posteriores).
  4. Click en Create Java Project

2. Abrir el asistente de Spring Initializr

Paso 2

  1. Abre la paleta de comandos:
  2. macOS: Cmd + Shift + P
  3. Windows/Linux: Ctrl + Shift + P
  4. Busca y selecciona una opción tipo:
  5. Spring Initializr: Generate a Spring Boot Project
  6. En la lista de tipos, selecciona Spring Boot (provisto por Spring Initializr Java Support).

3. Seleccionar tipo de proyecto: Maven

Paso 3

  1. En Select project type, elige:
  2. ✅ Maven Project
  3. (Opcional) Gradle también sirve, pero tu flujo es Maven.

4. Seleccionar versión de Spring Boot

Paso 4

  1. En Specify Spring Boot version, selecciona la versión que necesitas.
  2. En tu captura se ve seleccionada: 4.0.2.

Nota: Si ves versiones SNAPSHOT o M1, son pre-release. En la mayoría de casos conviene una estable.

5. Seleccionar lenguaje

Paso 5

  1. En Specify project language, elige:
  2. ✅ Java

6. Definir Group Id

Paso 6

  1. En Input Group Id, escribe el identificador de grupo.
  2. En la imagen: co.javeriana.dw
  3. Presiona Enter para confirmar.

Recomendación: usa un formato tipo dominio invertido (ej. co.empresa.proyecto).

7. Definir Artifact Id

Paso 7

  1. En Input Artifact Id, escribe el nombre del artefacto/proyecto.
  2. En la imagen: thymeleaf
  3. Presiona Enter.

Esto suele terminar siendo el nombre del folder del proyecto y el nombre base del build.

8. Definir Package Name

Paso 8

  1. En Input Package Name, define el paquete raíz.
  2. En tu captura: co.javeriana.dw.thymeleaf
  3. Presiona Enter.

Suele ser GroupId + ArtifactId (pero puedes ajustarlo).

9. Seleccionar Packaging: Jar o War

Paso 9

  1. En Specify packaging type, elegiste:
  2. ✅ War

¿Cuándo usar WAR?

  • Cuando vas a desplegar en un servidor externo (ej. Tomcat instalado aparte).

¿Cuándo usar JAR?

  • Cuando quieres ejecutar con java -jar ... y usar el Tomcat embebido de Spring Boot (lo más común).

Si tu objetivo es levantarlo rápido localmente con mvn spring-boot:run, normalmente conviene Jar.
Pero si ya decidiste War, perfecto: solo ten presente el objetivo de despliegue.

10. Seleccionar versión de Java (Imagen 10)

Paso 10

  1. En Specify Java version, selecciona:
  2. ✅ 21 (según tu captura)

Si tu entorno institucional pide LTS más “estándar”, 17 también es excelente.

11. Seleccionar dependencias

Paso 11

Cuando el asistente te pregunte por dependencias, agrega: - ✅ Spring Web (opcional, si vas a exponer endpoints/Controllers) - ✅ Thymeleaf

Opcionales útiles: - Spring Boot DevTools (recarga rápida en desarrollo) - Validation (formularios y validación)

Confirma y continúa.

12. Para terminar

Paso 12

  1. VSCode te pedirá una ubicación para guardar el proyecto.
  2. Selecciona una carpeta (por ejemplo: ~/Documents/desarrollo/).
  3. El asistente generará el proyecto y normalmente te preguntará:
  4. “¿Open the generated project?” → di que Sí.