Tutorials

VS Code für Spring Boot: Schritt-für-Schritt-Anleitung zur Erstellung und Ausführung eines Web-Projekts

Melden

Visual Studio Code (VS Code) hat sich von einem einfachen Texteditor zu einer vollwertigen, leichtgewichtigen Entwicklungsumgebung entwickelt. Dank eines mächtigen Ökosystems an Erweiterungen eignet sich VS Code hervorragend für die Java- und Spring-Boot-Entwicklung.

In diesem Tutorial lernst du, wie du deine Umgebung einrichtest, ein neues Spring-Boot-Webprojekt direkt in VS Code erstellst, einen REST-Endpunkt schreibst und die Anwendung ausführst.

1. Voraussetzungen

Bevor es losgeht, stelle sicher, dass folgende Software auf deinem Computer installiert ist:

  1. Java Development Kit (JDK): Mindestens Version 17 (oder höher, empfohlen wird ein LTS-Release wie Eclipse Temurin oder Oracle OpenJDK).
  2. Visual Studio Code: Die aktuelle Version.

2. Die wichtigsten VS Code Erweiterungen installieren

Damit VS Code Java und Spring Boot versteht, benötigst du zwei zentrale Erweiterungspakete.

Öffne VS Code, gehe auf das Extensions-Symbol in der linken Seitenleiste (oder drücke Strg + Umschalt + X bzw. Cmd + Shift + X auf dem Mac) und installiere:

  1. Extension Pack for Java (von Microsoft):
    Enthält alles Notwendige: Sprachunterstützung, Debugger, Maven/Gradle-Unterstützung und Projektverwaltung.
  2. Spring Boot Extension Pack (von VMware):
    Bietet Unterstützung für application.properties/application.yml, Spring-Code-Vervollständigung und das Spring-Boot-Dashboard.

3. Ein neues Spring Boot Projekt erstellen

Dank des Spring-Erweiterungspakets ist der Spring Initializr direkt in VS Code integriert.

  1. Öffne die Befehlspalette: Strg + Umschalt + P (Mac: Cmd + Shift + P).
  2. Tippe ein: Spring Initializr: Create a Maven Project und wähle den Befehl aus (du kannst alternativ auch Gradle wählen, Maven ist jedoch der Standard).
  3. Folge nun den Abfragen am oberen Bildschirmrand:
    • Spring Boot Version: Wähle die neueste stabile Version (ohne SNAPSHOT oder M-Zusatz).
    • Language: Java.
    • Group Id: z. B. com.example.
    • Artifact Id: z. B. demo oder vscodeweb.
    • Packaging Type: Jar.
    • Java Version: Wähle die Version, die auf deinem System installiert ist (z. B. 17 oder 21).
    • Dependencies (Abhängigkeiten): Tippe nachfolgende Abhängigkeiten ein und wähle sie aus:
      • Spring Web (essenziell für Webanwendungen und REST-APIs)
      • Spring Boot DevTools (optional, sorgt für automatische Neustarts bei Codeänderungen)
    • Drücke Enter, um die Auswahl zu bestätigen.
  4. Wähle einen Ordner auf deiner Festplatte aus, in dem das Projekt gespeichert werden soll.
  5. Nach der Generierung fragt VS Code unten rechts: „Open project?“ – Klicke auf Open.

4. Einen Web-Controller erstellen

Nun fügen wir dem Projekt einen einfachen REST-Endpunkt hinzu, um zu testen, ob der Webserver funktioniert.

  1. Navigiere im Dateiexplorer links zu:
    src > main > java > com > example > demo
  2. Klicke mit der rechten Maustaste auf den Ordner demo und wähle New File.
  3. Nenne die Datei: HelloController.java.
  4. Füge folgenden Java-Code ein:
package com.example.demo;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/")
    public String index() {
        return "Hallo! Das Spring-Boot-Projekt läuft erfolgreich in VS Code!";
    }
}

Speichere die Datei (Strg + S bzw. Cmd + S).

5. Das Spring-Boot-Projekt starten

Es gibt mehrere Möglichkeiten, die Anwendung in VS Code auszuführen:

Methode A: Über das Spring-Boot-Dashboard (Empfohlen)

In der linken Seitenleiste findest du ein Blatt-Symbol (Spring Boot Dashboard).

  1. Klicke auf das Symbol.
  2. Fahre mit der Maus über deine App (z. B. demo) in der Liste.
  3. Klicke auf das grüne Play-Symbol (Start) oder das Käfer-Symbol (Debug).

Methode B: Direkt aus der Hauptklasse

  1. Öffne die Datei DemoApplication.java.
  2. Über der Methode public static void main(...) siehst du kleine Textlinks: Run und Debug.
  3. Klicke auf Run.

Methode C: Über das integrierte Terminal

Öffne das Terminal (`Strg + ``) und gib folgenden Befehl ein:

  • Auf Windows: .\mvnw.cmd spring-boot:run
  • Auf macOS/Linux: ./mvnw spring-boot:run

6. Die Anwendung testen

Sobald im Terminal die Zeile Started DemoApplication in ... seconds erscheint:

  1. Öffne einen Webbrowser deiner Wahl.
  2. Navigiere zu folgender Adresse:
    http://localhost:8080
  3. Du solltest nun den Text sehen:
    "Hallo! Das Spring-Boot-Projekt läuft erfolgreich in VS Code!"

7. Debugging-Tipp für VS Code

Um deinen Code zu debuggen, kannst du links neben den Zeilennummern in den Editor klicken (z. B. innerhalb der index()-Methode im HelloController), um einen roten Haltepunkt (Breakpoint) zu setzen.

Wenn du die App im Debug-Modus startest und http://localhost:8080 im Browser aufrufst, hält VS Code an dieser Stelle an, und du kannst Variablenwerte, den Call Stack und mehr im Debug-Panel analysieren.

Fazit

Mit dem Extension Pack for Java und den Spring Boot Tools bietet Visual Studio Code eine vollständige und extrem schnelle Entwicklungsumgebung für Java. Du kannst neue Anwendungen via Spring Initializr anlegen, Code schreiben, Abhängigkeiten verwalten und deine Projekte ausführen oder debuggen – alles, ohne den Editor jemals verlassen zu müssen.

0