Sie geben java oder javac ein und das Terminal meldet, dass der Befehl nicht gefunden wurde.

Sofort: Prüfen Sie zuerst, ob ein JDK installiert ist und welchen Java-Pfad Ihr Terminal tatsächlich verwendet. Installieren Sie nicht vorschnell neu und ändern Sie keine Systempfade, bevor Sie die Kursvorgabe kennen. Diese Woche: Vergleichen Sie die angezeigte Version mit der Kursanforderung und testen Sie die Umgebung mit einem kleinen Kursprogramm.

Dieser Leitfaden ist für Sie gedacht, wenn Sie Java 27 auf einem Mac eingerichtet haben, aber Befehle fehlen oder eine unerwartete Version erscheint. Er hilft auch, wenn Sie mehrere JDKs installiert haben oder für einen Kurs über einen Remote-Mac arbeiten. Wenn Java noch nicht installiert ist, benötigen Sie zunächst eine Installationsanleitung; hier geht es um Fehler, die nach der Installation auftreten.

Zuletzt geprüft am 27.10.2026. Die Angaben zu Installation, Verzeichnissen und Versionsprüfung wurden mit der offiziellen Java-SE-27-Dokumentation abgeglichen.

01

Mac Java 27: Erst unterscheiden, welcher Befehl fehlt

Eine Meldung wie „command not found“ sagt zunächst nur, dass die aktuelle Terminal-Sitzung den eingegebenen Befehl nicht auflösen konnte. Sie beweist für sich allein weder, dass Java nie installiert wurde, noch dass der gesamte Rechner falsch eingerichtet ist.

Beginnen Sie mit diesen getrennten Prüfungen:

java -version
javac -version
/usr/libexec/java_home -V

Die Java-Dokumentation nennt java -version als Möglichkeit, die installierte Java-Version zu prüfen. Für macOS beschreibt sie außerdem das Dienstprogramm java_home und den Umgang mit mehreren JDK-Installationen. Die macOS-Installationsanleitung für Java SE 27 erläutert die Installation und die Versionsprüfung. Die Beschreibung der installierten JDK-Verzeichnisse zeigt, wie die Installation aufgebaut ist.

Lesen Sie die Ergebnisse einzeln:

  • java -version gibt eine Versionsmeldung aus: Ein Java-Startprogramm ist über diesen Terminalaufruf erreichbar. Das bedeutet noch nicht, dass es die vom Kurs geforderte Version ist.
  • java -version scheitert, aber java_home -V listet ein JDK: Der Mac erkennt möglicherweise eine Installation, während der Befehl java in dieser Sitzung nicht wie erwartet gefunden wird. Prüfen Sie den Pfad und die Terminalumgebung, bevor Sie neu installieren.
  • Beide Prüfungen zeigen kein passendes JDK: Prüfen Sie, ob die Installation tatsächlich abgeschlossen wurde und ob Sie im richtigen Benutzerkonto arbeiten. Nutzen Sie für einen erneuten Installationsversuch die offizielle Java-Downloadseite.
  • Nur javac -version scheitert: Behandeln Sie das als eigene Diagnose. Der Compiler und das Programm zum Starten von Java-Anwendungen erfüllen unterschiedliche Aufgaben.

Prüfen Sie auch Ihre Eingabe: Ein zusätzlicher Buchstabe, ein eingefügtes Leerzeichen oder eine abweichende Groß- und Kleinschreibung kann einen Befehl unbrauchbar machen. Geben Sie die Befehle erneut direkt ein, statt eine möglicherweise fehlerhafte Zeile aus einer Notiz zu kopieren.

02

Das Terminal kann ein anderes JDK als der Kurs verwenden

Die Bezeichnung „Java“ ist für die Fehlersuche zu ungenau. Ein JDK enthält Werkzeuge für Entwicklung und Kompilierung. Das Programm java startet eine Anwendung; javac übersetzt Java-Quelldateien. Die offizielle Beschreibung des java-Befehls und die Dokumentation zu javac erläutern diese getrennten Aufgaben.

Prüfen Sie deshalb nicht nur, ob irgendeine Java-Version reagiert. Vergleichen Sie die Kursvorgabe mit den Ausgaben dieser Befehle:

java -version
javac -version
echo "$JAVA_HOME"
/usr/libexec/java_home -V

Die Ausgaben von java -version und javac -version können unterschiedlich ausfallen. Das ist ein Anlass, die aufgerufenen Pfade und die Kursvorgabe genauer zu vergleichen. Ein gesetztes JAVA_HOME zeigt außerdem nicht automatisch, dass jeder Editor oder jedes Terminal dieses Verzeichnis verwendet. Umgekehrt beweist ein leeres JAVA_HOME für sich allein nicht, dass keine Java-Installation vorhanden ist.

Versionsnummern können Zusätze enthalten. Die Dokumentation zum Format der Java-Versionsangabe hilft, solche Bestandteile einzuordnen. Vergleichen Sie die vollständige Ausgabe mit der Kursvorgabe, statt nur auf die ersten Ziffern zu schauen. Wenn Ihr Kurs ausdrücklich Java 27 fordert, muss die verwendete Entwicklungsumgebung diese Anforderung erfüllen. Eine andere Version ist nicht deshalb passend, weil sie ebenfalls java ausführt.

Für macOS beschreibt die Dokumentation ein JDK-Verzeichnis unter /Library/Java/JavaVirtualMachines/. Der konkrete Verzeichnisname hängt von der installierten Version ab. Nutzen Sie diese Angabe als Orientierung, nicht als Anlass, Ordner manuell umzubenennen oder zu löschen. Die oben verlinkte JDK-Verzeichnisbeschreibung erläutert den Aufbau, ohne dass Sie einzelne Systemdateien verändern müssen.

03

Die Symptome geben den nächsten Schritt vor

Beobachtung Wahrscheinliche Richtung Nächster sicherer Schritt
java und javac werden beide nicht gefunden Installation nicht abgeschlossen oder Befehle in der Sitzung nicht erreichbar JDK-Erkennung prüfen und Installationsstatus verifizieren
java funktioniert, javac nicht Startprogramm erreichbar, Compiler-Aufruf oder JDK-Auswahl prüfen javac -version getrennt prüfen und JDK-Installation kontrollieren
Beide Befehle funktionieren, melden aber eine unerwartete Version Mehrere JDKs oder abweichende Werkzeugauswahl Kursvorgabe mit Terminal- und Editor-Version vergleichen
Terminal funktioniert, Editor nicht Editor verwendet möglicherweise eine eigene Projekteinstellung Projektlaufzeit nach dessen offizieller Dokumentation prüfen
Beide Befehle funktionieren, das Projekt scheitert Projekt-, Code- oder Abhängigkeitsproblem möglich Fehlermeldung und Kursprojekt untersuchen, Java nicht pauschal neu installieren

Die Tabelle ist eine Entscheidungshilfe, keine automatische Fehlerdiagnose. Wenn mehrere Ursachen möglich sind, notieren Sie zuerst die Ausgaben und ändern Sie danach nur den Teil, der nicht zur Kursanforderung passt. So lässt sich eine funktionierende Konfiguration leichter wiederherstellen.

04

So prüfen Sie die Umgebung ohne dauerhafte Änderungen

Gehen Sie diese Schritte der Reihe nach durch. Stoppen Sie, sobald die Ursache erkennbar ist.

  1. Kursvorgabe notieren. Halten Sie fest, welche Java-Version und welches Werkzeug der Kurs nennt. Prüfen Sie, ob eine konkrete JDK-Version verlangt wird oder ob eine allgemeine Java-Umgebung genügt. Wenn die Anforderung unklar ist, fragen Sie nach, bevor Sie eine bestehende Konfiguration verändern.

  2. Terminalausgaben sichern. Führen Sie java -version, javac -version, /usr/libexec/java_home -V und echo "$JAVA_HOME" aus. Kopieren Sie die vollständigen Ergebnisse in Ihre Kursnotizen. Diese Ausgangswerte zeigen später, ob eine Änderung geholfen hat oder ob ein zweites Werkzeug abweicht.

  3. Erkanntes JDK mit der Kursvorgabe vergleichen. Falls java_home -V eine passende Installation meldet, vergleichen Sie sie mit dem Kurs. Meldet der Befehl keine passende Installation, prüfen Sie zuerst den Installationsstatus und das verwendete Benutzerkonto. Vermeiden Sie Änderungen an Systemordnern und Sicherheitseinstellungen.

  4. Nur die aktuelle Sitzung testweise auswählen. Wenn ein passendes JDK erkannt wird, können Sie es für diese Terminal-Sitzung auswählen:

bash export JAVA_HOME=$(/usr/libexec/java_home -v 27) export PATH="$JAVA_HOME/bin:$PATH"

Verwenden Sie den Versionsselektor nur, wenn Ihr Kurs genau diese Version verlangt und java_home -V eine passende Installation anzeigt. Schlägt die Auswahl fehl oder bleibt JAVA_HOME leer, fahren Sie nicht mit blinden Pfadänderungen fort. Eine Einstellung für die aktuelle Sitzung ist zunächst ein Test; sie muss nicht dauerhaft gespeichert werden. Die macOS-spezifische Auswahl und Installation sollten Sie anhand der offiziellen Installationshinweise nachvollziehen.

  1. Befehle erneut getrennt prüfen. Führen Sie nach der temporären Auswahl wieder java -version und javac -version aus. Vergleichen Sie beide Ergebnisse mit der Kursvorgabe. Ein erfolgreicher Aufruf von java allein reicht nicht, wenn die Aufgabe Java-Quelldateien kompilieren lässt.

  2. Editor und Kurswerkzeug separat kontrollieren. Öffnen Sie die Projekteinstellungen des verwendeten Editors und vergleichen Sie dessen ausgewählte Laufzeit mit den Terminalausgaben. Die genaue Einstellung unterscheidet sich je nach Werkzeug. Verwenden Sie die Dokumentation des Editors oder die Kursanleitung, statt anzunehmen, dass ein geöffnetes Terminal und ein Editor dieselbe Umgebung übernehmen.

  3. Nach dem Test neu öffnen. Schließen Sie das Terminalfenster, öffnen Sie ein neues und wiederholen Sie die Versionsprüfungen. So sehen Sie, ob Ihre Änderung nur für die vorherige Sitzung galt oder auch in einer neu gestarteten Sitzung wirksam ist. Speichern Sie keine dauerhafte Pfadänderung, solange Kursanforderung und Rückweg nicht klar sind.

Wenn Sie für Ihre Kursarbeit erst klären müssen, welche Mac-Umgebung verfügbar ist, können Sie die Übersicht zu den Mac-Umgebungen als Orientierung nutzen. Das ersetzt nicht die Prüfung Ihrer JDK-Version; es hilft Ihnen lediglich, die Frage nach dem verwendeten Rechner getrennt von der Frage nach der Java-Konfiguration zu betrachten.

05

javac fehlt: Compilerproblem oder falscher Pfad?

Ein häufiges Missverständnis lautet: Wenn java eine Version anzeigt, müsse javac ebenfalls verfügbar sein. Das muss nicht so sein. java startet Programme. javac kompiliert Quelltext. Die verlinkte Dokumentation zum javac-Befehl zeigt, welche Rolle der Compiler beim Erstellen von Java-Programmen hat.

Prüfen Sie in dieser Reihenfolge:

  • Meldet javac -version eine Version? Dann ist der Compiler-Befehl erreichbar. Vergleichen Sie die Ausgabe mit der Kursvorgabe.
  • Meldet java -version eine Version, javac -version aber einen Fehler? Prüfen Sie, ob der aktuell verwendete Pfad auf ein vollständiges JDK zeigt und nicht auf eine andere Java-Umgebung.
  • Listet /usr/libexec/java_home -V mehrere JDKs? Notieren Sie die angezeigten Installationen. Ändern Sie nicht die Verzeichnisse selbst; wählen Sie die passende Version über die für Ihr Werkzeug vorgesehene Einstellung.
  • Findet java_home kein passendes JDK? Prüfen Sie Installation und Installationsquelle, bevor Sie Umgebungsvariablen dauerhaft bearbeiten.

Ein fehlender javac-Befehl ist also nicht automatisch ein PATH-Fehler. Wenn der Compiler nicht installiert oder nicht Teil der ausgewählten Umgebung ist, löst eine beliebige Änderung an PATH das eigentliche Problem nicht. Prüfen Sie außerdem, ob Sie in einem eingeschränkten Schul- oder Laborprofil arbeiten. Manche Geräte lassen Softwareänderungen nicht zu. In diesem Fall sollte die zuständige Administration oder Ihre Lehrkraft den vorgesehenen Weg nennen.

06

Terminal und Editor liefern verschiedene Ergebnisse

Ein typischer Lernfall: Im Terminal wird die vom Kurs verlangte Version angezeigt, aber beim Start des Projekts meldet der Editor eine andere Java-Version. Das ist nicht zwingend ein Installationsfehler. Terminal und Editor können getrennte Einstellungen oder Startkontexte verwenden.

Notieren Sie die Ergebnisse nebeneinander, ohne zunächst etwas umzuschalten:

  • Ausgabe von java -version im Systemterminal.
  • Ausgabe von javac -version im Systemterminal.
  • Angezeigte Laufzeit oder JDK-Auswahl in den Projekteinstellungen.
  • Fehlermeldung, die beim Kompilieren oder Starten des Kursprojekts erscheint.

Prüfen Sie anschließend in der Anleitung Ihres Kurswerkzeugs, wie die Laufzeit für ein Projekt ausgewählt wird. Eine im Terminal gesetzte Umgebungsvariable ist kein verlässlicher Beweis dafür, dass ein bereits geöffnetes Programm dieselbe Auswahl übernimmt. Wenn die Version nur im Editor abweicht, korrigieren Sie die Projekteinstellung dort, statt die Systemumgebung des Macs zu verändern.

Wichtig ist auch der Unterschied zwischen einem Befehlsfehler und einem Projektfehler. „Befehl nicht gefunden“ betrifft die Erreichbarkeit eines Werkzeugs. Eine Meldung über einen ungültigen Typ, eine fehlende Bibliothek oder einen Fehler in einer Quelldatei kann dagegen aus dem Projekt, dem Code oder dessen Abhängigkeiten stammen. Prüfen Sie, an welcher Stelle der Ablauf stoppt: beim Aufruf von java, beim Aufruf von javac, beim Kompilieren oder erst beim Programmstart.

Wenn Sie über einen Remote-Mac lernen, notieren Sie außerdem, ob Sie die Prüfung im Systemterminal, in einem Editor-Terminal oder in einer Webkonsole ausführen. Die Oberfläche, über die Sie zugreifen, ändert nicht die Kursanforderung; sie kann aber beeinflussen, welche Sitzung und welche Einstellungen gerade aktiv sind. Verlassen Sie sich daher auf die Befehlsausgaben der konkreten Sitzung, in der Sie die Kursaufgabe bearbeiten.

07

Reparatur mit einer kleinen Kursaufgabe bestätigen

Ändern Sie nicht mehrere Dinge auf einmal. Verwenden Sie eine kleine Aufgabe, die zu Ihrem Kurs passt, damit Sie erkennen, ob die JDK-Auswahl wirklich stimmt. Legen Sie eine Datei mit dem Namen Main.java an und verwenden Sie zum Beispiel:

public class Main {
    public static void main(String[] args) {
        System.out.println("Java bereit");
    }
}

Wechseln Sie im Terminal in den Ordner mit der Datei. Kompilieren Sie sie und starten Sie anschließend das erzeugte Programm:

javac Main.java
java Main

Wenn die Kompilierung gelingt und die Ausgabe erscheint, funktionieren beide Befehle in dieser Sitzung für diesen kleinen Test. Das bestätigt aber noch nicht, dass Ihr gesamtes Kursprojekt oder Ihr Editor dieselbe Version nutzt. Die Befehlsbeschreibungen für den Compiler und das Java-Startprogramm erklären die jeweiligen Aufgaben; bei einer Fehlermeldung sollten Sie daher genau feststellen, welcher Schritt scheitert.

Falls der Kompilierschritt misslingt, lesen Sie die konkrete Fehlermeldung, bevor Sie Änderungen vornehmen. Ein falsch gewähltes Verzeichnis, ein abweichender Dateiname oder ein Problem im Quelltext kann ebenfalls eine Rolle spielen. Scheitert nur das größere Kursprojekt, behandeln Sie das nicht automatisch als Installationsproblem: Prüfen Sie dessen Abhängigkeiten, Projektvorgaben und Editor-Einstellungen.

Öffnen Sie nach dem Test ein neues Terminal und kontrollieren Sie die Versionen erneut. Erfüllt die neue Sitzung die Kursanforderung, dokumentieren Sie die funktionierende Einstellung. Fällt sie auf eine andere Version zurück, gilt die Änderung wahrscheinlich nur für die vorherige Sitzung. Entscheiden Sie erst dann, ob eine dauerhafte Einstellung nötig ist, und folgen Sie dafür der offiziellen Dokumentation Ihres Terminals oder Ihrer Entwicklungsumgebung.

Hören Sie mit der Fehlersuche auf, wenn java und javac die erwartete Version melden und das kleine Programm korrekt kompiliert und startet. Wenn danach nur eine Kursanwendung scheitert, prüfen Sie das Projekt oder fragen Sie die Lehrkraft. Ändern Sie weder geschützte Systemordner noch Geräteverwaltungseinstellungen, um eine Projektfehlermeldung zu umgehen.

08

Häufige Fragen

Warum findet mein Mac Java nach der Installation nicht?

Prüfen Sie zunächst, ob das JDK installiert ist und ob das Terminal den passenden Java-Pfad aufrufen kann. Mit java -version sehen Sie, ob ein Java-Programm erreichbar ist; /usr/libexec/java_home -V listet erkannte JDK-Installationen auf. Liefert der zweite Befehl kein passendes Ergebnis, suchen Sie zuerst nach einem Installations- oder Erkennungsproblem, statt blind PATH-Einträge zu ändern.

Was kann ich tun, wenn java funktioniert, aber javac fehlt?

java startet Programme, während javac Java-Quelldateien kompiliert. Prüfen Sie beide Befehle getrennt und kontrollieren Sie, ob das verwendete JDK auch den Compiler enthält. Wenn Sie eine andere Java-Umgebung oder einen abweichenden JDK-Pfad verwenden, ist javac nicht zwingend über denselben Aufruf verfügbar. Folgen Sie der Installationsdokumentation und ändern Sie keine Systemdateien.

Wie sehe ich, welches JDK mein Mac-Terminal verwendet?

Geben Sie java -version und javac -version ein, um die von den Befehlen gemeldeten Versionen zu vergleichen. Ergänzen Sie die Prüfung durch /usr/libexec/java_home -V, das erkannte JDK-Installationen anzeigt, sowie echo "$JAVA_HOME", das den gesetzten Umgebungswert ausgibt. Diese Ergebnisse beschreiben die aktuelle Terminal-Sitzung; ein Editor kann eine andere Laufzeit verwenden.

Was mache ich, wenn mein Kurs ein anderes Java als das Terminal verlangt?

Notieren Sie zuerst die Kursvorgabe und die Versionen, die Terminal und Editor tatsächlich melden. Gibt es mehrere erkannte JDKs, wählen Sie die passende Version nach der offiziellen Anleitung des jeweiligen Werkzeugs oder den Kursunterlagen. Ändern Sie zunächst nur die aktuelle Terminal-Sitzung und prüfen Sie anschließend ein Kursprogramm. Bleibt der Unterschied im Editor bestehen, kontrollieren Sie dessen Projekteinstellungen.

Wenn die Prüfungen zeigen, dass lediglich Java im Terminal falsch ausgewählt ist, brauchen Sie dafür nicht automatisch einen anderen Rechner. Fehlt Ihnen dagegen eine nutzbare macOS-Lernumgebung – etwa weil Ihr Schulgerät Installationen blockiert oder Sie Kursaufgaben auf dem eigenen Rechner nicht ausführen können –, kann ein gemieteter Remote-Mac den Zugang zu macOS ermöglichen. Planen Sie dabei eine stabile Netzwerkverbindung ein und bedenken Sie, dass Fernzugriff anders ist als lokale Arbeit. Er behebt weder eine falsche Projektvorgabe noch einen Fehler im Code.

Vergleichen Sie die Mietkosten für Mac-Umgebungen mit Ihrer tatsächlichen Nutzung. Wenn Sie nur einen Terminalbefehl korrigieren müssen, ist eine Miete wahrscheinlich unnötig. Fehlt Ihnen für wiederkehrende Kursaufgaben eine passende Mac-Umgebung, können Sie bei VpsMesh die verfügbaren Möglichkeiten prüfen und danach entscheiden, ob Fernzugriff zu Ihrem Kurs passt.