HOWTO · Git

Git zu PATH unter Windows hinzufügen

In diesem Artikel wird das Hinzufügen des Git-Programms zur Windows-Pfadumgebungsvariablen erläutert.

Auf dieser Seite

Um Git-Befehle unter Windows aus einem beliebigen Arbeitsverzeichnis auszuführen, fügen Sie das Verzeichnis, das die ausführbare Befehlszeilendatei von Git enthält, zur Umgebungsvariablen PATH hinzu. Sie können dies in den Windows-Umgebungsvariablen oder dauerhaft mit PowerShell tun. Öffnen Sie dann ein neues Terminal und überprüfen Sie die Git-Version.

Git zu PATH unter Windows hinzufügen

PATH ist eine Liste von Verzeichnissen, die Windows durchsucht, wenn Sie einen Befehl eingeben. Fügen Sie ein Verzeichnis hinzu, nicht die Datei git.exe selbst. Für eine typische Git-for-Windows-Installation verwenden Sie C:\Program Files\Git\cmd. Das nebengeordnete Verzeichnis bin kann für andere Git-Werkzeuge nützlich sein, fügen Sie es aber nur hinzu, wenn Sie diese Werkzeuge benötigen. Wenn Git an einem anderen Ort installiert ist, suchen Sie zuerst dessen Verzeichnis cmd.

Sie können entweder Ihr Benutzer-Path oder das System-Path bearbeiten. Ein Benutzereintrag gilt für Ihr Windows-Konto und erfordert normalerweise keine Administratorrechte. Ein Systemeintrag gilt für alle Benutzer und erfordert eine Administratorberechtigung.

  1. Suchen Sie in Windows nach Systemumgebungsvariablen bearbeiten und öffnen Sie das Ergebnis.

    Nach „Umgebungsvariablen bearbeiten" suchen

  2. Wählen Sie in den Systemeigenschaften Umgebungsvariablen. Sie erreichen die Systemeigenschaften auch, indem Sie mit der rechten Maustaste auf Dieser PC klicken, Eigenschaften wählen und dann Erweiterte Systemeinstellungen öffnen.

    Eigenschaften von „Dieser PC"

  3. Wählen Sie unter Benutzervariablen oder Systemvariablen den Eintrag Path und dann Bearbeiten. Wählen Sie den Benutzereintrag für eine Änderung, die nur Ihr Konto betrifft.

    Systemvariablen bearbeiten

  4. Wählen Sie Neu, geben Sie das Verzeichnis cmd von Git ein (zum Beispiel C:\Program Files\Git\cmd) und speichern Sie die Dialoge. Geben Sie nicht C:\Program Files\Git\bin\git.exe ein; PATH-Einträge müssen Verzeichnisse sein.

    Git zu PATH hinzufügen

Bei PortableGit kann der Speicherort unter C:\Users\<user>\AppData\Local\GitHub\PortableGit_<guid> liegen. Überprüfen Sie die tatsächliche Installation auf Ihrem Computer und fügen Sie dann dessen Verzeichnis cmd hinzu. Fügen Sie dessen Verzeichnis bin nur hinzu, wenn Sie die zusätzlichen dortigen Werkzeuge benötigen.

Git mit PowerShell zu PATH hinzufügen

PowerShell kann ein Verzeichnis dauerhaft in Ihrem Benutzer-PATH speichern, ohne die vorhandenen Einträge zu ersetzen. Das folgende eigenständige Beispiel geht davon aus, dass Git am standardmäßigen Program-Files-Speicherort installiert ist. Es prüft dieses Verzeichnis und fügt es nur hinzu, wenn es nicht bereits vorhanden ist. Dieses Windows-spezifische Beispiel ist in den bereitgestellten Laufzeitnachweisen nicht ausgeführt; überprüfen Sie vor der Verwendung den Installationsort.

$gitCmd = Join-Path $env:ProgramFiles 'Git\cmd'
if (Test-Path -LiteralPath $gitCmd -PathType Container) {
    $userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
    $entries = @($userPath -split ';' | Where-Object { $_ })
    $alreadyPresent = $entries | Where-Object { $_.TrimEnd('\') -ieq $gitCmd.TrimEnd('\') }
    if (-not $alreadyPresent) {
        $newPath = (@($entries) + $gitCmd) -join ';'
        [Environment]::SetEnvironmentVariable('Path', $newPath, 'User')
    }
}

Das Ziel User ändert das dauerhafte PATH für Ihr Konto; es erfordert kein PowerShell-Fenster mit erhöhten Rechten. Wenn Git an einem anderen Ort installiert ist, setzen Sie $gitCmd auf das Verzeichnis cmd dieser Installation. Eine Änderung von $env:Path allein betrifft nur den aktuellen PowerShell-Prozess und seine Kindprozesse und ist daher kein dauerhafter Ersatz für diese Methode.

Git in einem neuen Terminal überprüfen

Schließen Sie vorhandene Fenster der Eingabeaufforderung oder von PowerShell, öffnen Sie ein neues und führen Sie git --version aus. Neue Terminals erhalten die aktualisierte Umgebung; ein bereits geöffnetes Terminal verwendet unter Umständen noch sein bisheriges PATH.

Git-Version in der Eingabeaufforderung prüfen

Wenn der Befehl eine Version ausgibt, kann Windows Git unter seinem Namen finden. Dies bestätigt die Befehlserkennung; es überprüft weder ein Repository noch Ihre Git-Konfiguration.

Fehlerbehebung, wenn Git nicht erkannt wird

Wenn ein neues Terminal meldet, dass git nicht erkannt wird, überprüfen Sie diese Punkte:

  • Vergewissern Sie sich, dass Git installiert ist und dass das hinzugefügte Verzeichnis cmd existiert. Standardmäßig ist dies üblicherweise C:\Program Files\Git\cmd, aber ein Installer oder PortableGit kann einen anderen Speicherort verwenden.
  • Stellen Sie in den Umgebungsvariablen sicher, dass das Verzeichnis als Path-Eintrag vorhanden ist. Der Eintrag sollte auf cmd enden, nicht auf git.exe.
  • Öffnen Sie nach dem Speichern der Änderung ein weiteres neues Terminal. Vorhandene Fenster laden PATH nicht automatisch neu.
  • Wenn Sie das System-Path bearbeitet haben, vergewissern Sie sich, dass die Änderung mit Administratorberechtigung gespeichert wurde. Verwenden Sie für ein einzelnes Konto stattdessen das Benutzer-Path.

Sobald sich das richtige Verzeichnis in PATH befindet, sollte git --version in einem neuen Terminal die installierte Version anzeigen.