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.
-
Suchen Sie in Windows nach Systemumgebungsvariablen bearbeiten und öffnen Sie das Ergebnis.
-
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.
-
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.
-
Wählen Sie Neu, geben Sie das Verzeichnis
cmdvon Git ein (zum BeispielC:\Program Files\Git\cmd) und speichern Sie die Dialoge. Geben Sie nichtC:\Program Files\Git\bin\git.exeein;PATH-Einträge müssen Verzeichnisse sein.
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.
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
cmdexistiert. Standardmäßig ist dies üblicherweiseC:\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 aufcmdenden, nicht aufgit.exe. - Öffnen Sie nach dem Speichern der Änderung ein weiteres neues Terminal. Vorhandene Fenster laden PATH nicht automatisch neu.
- Wenn Sie das System-
Pathbearbeitet 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.