Tutorials

Tutorial: Java-Fehler "Could not find or load main class" in VS Code lösen

Melden

Hier ist ein ausführliches Tutorial, um den Java-Fehler „Could not find or load main class“ in Visual Studio Code (VS Code) zu beheben.

Dieser Fehler tritt auf, wenn die Java Virtual Machine (JVM) die Klasse mit der main-Methode nicht finden oder nicht darauf zugreifen kann. Dies liegt meist an einer falschen Projektstruktur, falschen Pfaden oder Problemen mit dem Cache von VS Code.

Hier sind die effektivsten Lösungen:

1. Die Grundlagen prüfen (Syntax & Dateiname)

Bevor du tief in die Einstellungen gehst, prüfe diese drei Punkte:

  • Dateiname: Der Name der Datei muss exakt mit dem Klassennamen übereinstimmen.
    • Beispiel: public class MainApp muss in der Datei MainApp.java gespeichert sein.
  • Main-Methode: Hast du die Methode korrekt geschrieben?
    • public static void main(String[] args) { ... }
  • Package-Deklaration: Wenn deine Datei in einem Unterordner (z. B. src/com/beispiel) liegt, muss die erste Zeile in deinem Code package com.beispiel; lauten.

2. Den Java Language Server-Workspace bereinigen (Meistens die Lösung)

VS Code speichert Informationen über dein Projekt in einem Cache. Wenn dieser beschädigt ist, findet VS Code die Hauptklasse nicht mehr.

  1. Drücke Strg + Shift + P (Windows) oder Cmd + Shift + P (Mac), um die Befehlspalette zu öffnen.
  2. Tippe ein: „Java: Clean Java Language Server Workspace“.
  3. Wähle den Befehl aus und bestätige mit „Restart and delete“.
  4. VS Code startet neu und baut den Index deines Projekts sauber neu auf.

3. Den Quelltext-Ordner (Source Path) korrekt festlegen

VS Code muss wissen, wo der Quellcode beginnt, um die Packages korrekt zu interpretieren.

  1. Suche in der Seitenleiste (Explorer) deinen Ordner, in dem der Code liegt (meistens src).
  2. Rechtsklick auf den Ordner.
  3. Wähle „Add Folder to Java Source Path“.
  4. Falls dies nicht angezeigt wird: Gehe in die Datei-Ansicht ganz unten auf den Bereich „Java Projects“. Dort kannst du unter „Source Paths“ prüfen, ob dein Ordner gelistet ist.

4. Die „launch.json“ Datei korrigieren

Wenn du zum Starten die F5-Taste oder den „Run“-Button nutzt, verwendet VS Code eine Konfigurationsdatei. Wenn diese veraltet ist, zeigt sie auf die falsche Klasse.

  1. Gehe links auf das „Run and Debug“ Icon (Käfer-Symbol).
  2. Klicke auf das kleine Zahnrad-Icon oben, um die launch.json zu öffnen.
  3. Suche den Eintrag "mainClass".
  4. Stelle sicher, dass hier der vollständig qualifizierte Name steht (z. B. com.beispiel.MainApp statt nur MainApp).
  5. Tipp: Du kannst die launch.json auch einfach löschen und VS Code beim nächsten Klick auf „Run“ eine neue, saubere Version erstellen lassen.

5. Das Projekt manuell kompilieren

Manchmal hilft es, die .class-Dateien manuell zu erzwingen:

  1. Öffne das integrierte Terminal in VS Code.
  2. Kompiliere die Datei mit: javac DeineDatei.java
  3. Führe sie aus mit: java DeineDatei (ohne die Endung .class).
    • Hinweis: Wenn du ein Package nutzt, musst du aus dem Hauptverzeichnis heraus starten: java com.beispiel.DeineDatei.

Zusammenfassung der Checkliste

  • [ ] Stimmt der Dateiname mit dem Klassennamen überein?
  • [ ] Ist die package-Angabe in der ersten Zeile korrekt?
  • [ ] Hast du „Java: Clean Java Language Server Workspace“ ausgeführt?
  • [ ] Ist der src-Ordner als Source Path markiert?

Mit diesen Schritten sollte der Fehler in 99 % der Fälle behoben sein. Viel Erfolg beim Programmieren!

0