how to switch java versions in windowshow to switch java versions in windows
HappyCoders Glasses

Java-Version ändern unter Windows
(aktualisiert für Java 21)

Sven Woltmann
Sven Woltmann
Aktualisiert: 11. Januar 2024

In diesem Artikel zeige ich dir, wie du mehrere Java-Versionen unter Windows installierst und wie du die Java-Version auf der Kommandozeile und in der PowerShell ändern kannst:

Mehrere Java-Versionen unter Windows

Um diese Kommandos zum Wechsel der Java-Version auch auf deinem System zu ermöglichen, folge dieser einfachen Schritt-für-Schritt-Anleitung.

Los geht's…

Schritt 1: Installation mehrerer Java-Versionen

Mehrere Java-Versionen parallel zu installieren ist unter Windows kinderleicht. Du kannst einfach die Installer der einzelnen Versionen herunterladen und ausführen – jede Version wird dabei automatisch in ein separates Verzeichnis installiert.

Downloadquellen

  • Java SE 1.1 – Diese Version lässt sich auf einem 64-Bit-Windows nicht mehr installieren.
  • Java SE 1.2 – Wird standardmäßig nach C:\jdk1.2.2\ und C:\Program Files (x86)\JavaSoft\JRE\1.2\ installiert – ich empfehle das der Übersicht halber auf C:\Program Files (x86)\Java\jdk1.2.2\ und C:\Program Files (x86)\Java\jre1.2.2\ zu ändern.
  • Java SE 1.3 – Wird standardmäßig nach C:\jdk1.3.1_28\ installiert – ich empfehle das auf C:\Program Files (x86)\Java\jdk1.3.1_28\ zu ändern.
  • Java SE 1.4 – Wird standardmäßig nach C:\j2sdk1.4.2_19\ installiert – ich empfehle das auf C:\Program Files (x86)\Java\jdk1.4.2_19\ zu ändern.

Ab den folgenden Versionen sollten die Standard-Installationsverzeichnisse beibehalten werden:

Achtung – folgende Versionen dürfen in der Oracle-Distribution nur noch für private Zwecke und zur Entwicklung eingesetzt werden:

Die folgende Version ist zum aktuellen Zeitpunkt ein Early Access Build und sollte nur zum Testen verwendet werden:

Schritt 2: Java-Umgebungsvariablen definieren

Welche Java-Version verwendet wird, entscheiden die folgenden zwei Umgebungsvariablen:

  • JAVA_HOME – viele Start-Skripte verwenden diese Variable.
  • Path – wird verwendet, wenn man aus der Konsole eine Java-Binary (java, javac, etc...) aufruft.

Diese Variablen sollten immer auf die gleiche Java-Installation zeigen, um Inkonsistenzen zu vermeiden. Manche Programme, wie z. B. Eclipse definieren die Java-Version in einer eigenen Konfigurationsdatei (bei Eclipse ist dies bspw. der Eintrag "-vm" in der Datei eclipse.ini).

Manuelles Setzen der Java-Umgebungsvariablen

Die Java-Installer legen bereits diverse Umgebungsvariablen an, welche zunächst einmal aufgeräumt werden müssen. Der schnellste Weg die Umgebungsvariablen zu ändern, ist es die Windows-Taste zu drücken und dann "env" einzutippen – als Suchergebnis wird dann direkt "Edit the system environment variables" angeboten:

Windows-Umgebungsvariablen öffnen
Windows-Umgebungsvariablen öffnen

An dieser Stelle kannst du einfach auf "Enter" drücken, um die Systemeigenschaften zu öffnen:

Windows Systemeigenschaften
Windows Systemeigenschaften

Klicke auf "Environment Variables..." und das folgende Fenster erscheint:

Windows Umgebungsvariablen Java 20
Windows Umgebungsvariablen Java 20

Als Standardversion empfehle ich die aktuelle Release-Version Java 21. Dementsprechend sollten folgende Einstellungen vorgenommen werden:

  • In der oberen Liste ("User variables") sollte es keinerlei Java-Einträge geben.
  • In der unteren Liste ("System variables") sollte ein Eintrag "JAVA_HOME = C:\Program Files\Java\jdk-21" existieren. Wenn dieser Eintrag nicht existiert, kannst du ihn mittels "New..." hinzufügen. Wenn er existiert, aber auf ein anderes Verzeichnis zeigt, kannst du ihn mit "Edit..." ändern.
  • Unter "Path" solltest du, falls vorhanden, die folgenden Einträge löschen (diese werden von den Installern der Uralt-Versionen gesetzt):
    • C:\ProgramData\Oracle\Java\javapath
    • C:\Program Files (x86)\Common Files\Oracle\Java\javapath
  • Stattdessen solltest du folgenden Eintrag einfügen:
    • %JAVA_HOME%\bin

Der Eintrag sollte dann wie folgt aussehen (die übrigen Einträge der Liste werden bei dir wahrscheinlich anders aussehen, da du andere Anwendungen installiert hast als ich):

Hinzufügen von "%JAVA_HOME%\bin" zur Systemvariable "Path"
Hinzufügen von "%JAVA_HOME%\bin" zur Systemvariable "Path"

Der letzte Eintrag sorgt dafür, dass Path und JAVA_HOME automatisch konsistent sind.

Achtung: das funktioniert nur für die an dieser Stelle hinterlegte Standardeinstellung. Ändert man JAVA_HOME über die Kommandozeile, muss man Path entsprechend anpassen. Aber keine Sorge – das machen die Skripte, die du dir im nächsten Schritt herunteladen kannst, automatisch.

Java-Version prüfen unter Windows

Öffne nun eine Kommandozeile, um die Einstellungen mit den folgenden Befehlen zu prüfen:

echo %JAVA_HOME%
java -versionCode-Sprache: Klartext (plaintext)

Als Ergebnis solltest du folgendes sehen:

Java-Version prüfen unter Windows
Java-Version prüfen unter Windows

Schritt 3: Scripte zum Wechsel der Java-Version installieren

Um die Java-Version auf der Kommandozeile zu ändern, habe ich einige Batch-Dateien vorbereitet, die du dir auf dein System kopieren kannst. Hier schon einmal der Link (bis zur Early Access Version Java 21): scripts-up-to-java21.zip

Die ZIP-Datei enthält Skripte mit den Namen

  • java21.bat, java20.bat, java19.bat, usw. für alle Java-Versionen,
  • die entsprechenden Dateien java21.ps1, java20.ps1, usw. für die PowerShell,
  • sowie jeweils ein allgemeinens Skript javaX.bat bzw. javaX.ps1.

Ich schlage dir vor, die Skripte in das Verzeichnis C:\Program Files\Java\scripts zu entpacken.

Die Skripte sehen beispielsweise so aus:

java20.bat:

@echo off
call javaX "Java 20" %1Code-Sprache: DOS .bat (dos)

java20.ps1:

javaX "Java 20" $args[0]Code-Sprache: PowerShell (powershell)

javaX.bat:

@echo off

if %1 == "Java 1.2" set JAVA_HOME=C:\Program Files (x86)\Java\jdk1.2.2
if %1 == "Java 1.3" set JAVA_HOME=C:\Program Files (x86)\Java\jdk1.3.1_28
...
if %1 == "Java 20" set JAVA_HOME=C:\Program Files\Java\jdk-20
if %1 == "Java 21" set JAVA_HOME=C:\Program Files\Java\jdk-21

if "%~2" == "perm" (
  setx JAVA_HOME "%JAVA_HOME%" /M
)

set Path=%JAVA_HOME%\bin;%Path%

echo %~1 activated.Code-Sprache: DOS .bat (dos)

javaX.ps1:

param ($javaVersion, $perm)

switch ($javaVersion) {
  "Java 1.2" { $env:JAVA_HOME = "C:\Program Files (x86)\Java\jdk1.2.2" }
  "Java 1.3" { $env:JAVA_HOME = "C:\Program Files (x86)\Java\jdk1.3.1_28" }
  ...
  "Java 20" { $env:JAVA_HOME = "C:\Program Files\Java\jdk-20" }
  "Java 21" { $env:JAVA_HOME = "C:\Program Files\Java\jdk-21" }
}

if ($perm -eq "perm") {
  [Environment]::SetEnvironmentVariable("JAVA_HOME", $env:JAVA_HOME, [System.EnvironmentVariableTarget]::Machine)
}

$env:Path = $env:JAVA_HOME + '\bin;' + $env:Path

Write-Output "$javaVersion activated."Code-Sprache: PowerShell (powershell)

In den Dateien javaX.bat und javaX.ps1 musst Du vermutlich einige Pfade zu den installierten Java-Versionen anpassen.

Die Skripte aktualisieren die JAVA_HOME-Umgebungsvariable und fügen das darin liegende bin-Verzeichnis am Anfang der Path-Variable ein. Dadurch wird dieses beim Aufruf von Java-Befehlen wie java oder javac als erstes nach der entsprechenden Executable durchsucht.

(Die Path-Variable wird mit jedem Umschalten länger. Mach dir darüber keine Sorgen. Dies betrifft nur die aktuell geöffnete Kommandozeile.)

Schritt 4: Füge das Skript-Verzeichnis zum Pfad hinzu

Damit du die Skripte von überall aufrufen kannst, musst du das Verzeichnis zur "Path"-Umgebungsvariablen hinzuzufügen (genau wie du es im zweiten Schritt mit "%JAVA_HOME%\bin" gemacht hast):

 Hinzufügen von "C:\Program Files\Java\scripts" zur Systemvariable "Path"
Hinzufügen von "C:\Program Files\Java\scripts" zur Systemvariable "Path"

Wenn Du von allen Java-Versionen die aktuellsten Releases installiert hast, solltest du die Skripte ohne weitere Anpassungen verwenden können. Öffne eine neue Kommandozeile oder PowerShell und gib z. B. die folgenden Kommandos ein:

Umschalten der Java-Version in der PowerShell
Umschalten der Java-Version in der PowerShell

Wenn eines der Kommandos nicht die erwartete Java-Version aktiviert, dann prüfe bitte, ob der Pfad in der javaX.bat- bzw. javaX.ps1-Datei dem Installationspfad der zu aktivierenden Java-Version entspricht.

Temporäre und permanente Änderungen der Java-Version

Die Kommandos wirken sich zunächst nur auf die aktuell geöffnete Kommandozeile oder PowerShell aus. Sobald du eine andere Kommandozeile/PowerShell öffnest, ist wieder die in Schritt 2 festgelegte Standard-Version aktiv (Java 20, wenn du nichts geändert hast).

Wenn du die Java-Version permanent ändern möchtest, füge zu dem entsprechenden Kommando einfach den Parameter "perm" hinzu, z. B.

java20 perm

Achtung: Um die Java-Version permanent zu setzen, musst du die Kommandozeile bzw. die PowerShell als Administrator öffnen. Ansonsten bekommst du die Fehlermeldung "ERROR: Access to the registry path is denied."

Was du als nächstes tun solltest…

Ich hoffe, dass du der Anleitung gut folgen konntest und dass die Kommandos bei dir funktionieren.

Jetzt würde ich gerne von dir hören:

Konntest du den Schritten gut folgen – oder hast du noch offene Fragen?

So oder so, lass es mich wissen, indem du unten einen Kommentar hinterlässt.