Ajouter Git à PATH sous Windows

Pour exécuter des commandes Git depuis n’importe quel répertoire de travail sous Windows, ajoutez le répertoire contenant l’exécutable en ligne de commande de Git à la variable d’environnement PATH. Vous pouvez le faire dans les variables d’environnement Windows ou de façon persistante avec PowerShell. Ouvrez ensuite un nouveau terminal et vérifiez la version de Git.

Ajouter Git à PATH sous Windows

PATH est une liste de répertoires que Windows parcourt lorsque vous saisissez une commande. Ajoutez un répertoire, et non le fichier git.exe lui-même. Pour une installation typique de Git pour Windows, utilisez C:\Program Files\Git\cmd. Le répertoire frère bin peut être utile pour d’autres utilitaires Git, mais ajoutez-le uniquement si vous avez besoin de ces outils. Si Git est installé ailleurs, repérez d’abord son répertoire cmd.

Vous pouvez modifier votre Path utilisateur ou le Path système. Une entrée utilisateur s’applique à votre compte Windows et ne requiert normalement aucun accès administrateur. Une entrée système s’applique à tous les utilisateurs et requiert une autorisation d’administrateur.

1. Recherchez dans Windows Modifier les variables d’environnement système et ouvrez-le.

   

2. Dans Propriétés système, sélectionnez Variables d’environnement. Vous pouvez aussi atteindre Propriétés système en cliquant avec le bouton droit sur Ce PC, en choisissant Propriétés, puis en ouvrant Paramètres système avancés.

   

3. Sous Variables utilisateur ou Variables système, sélectionnez Path, puis choisissez Modifier. Choisissez l’entrée utilisateur pour un changement limité à votre compte.

   

4. Sélectionnez Nouveau, saisissez le répertoire cmd de Git (par exemple C:\Program Files\Git\cmd) et enregistrez les boîtes de dialogue. Ne saisissez pas C:\Program Files\Git\bin\git.exe ; les entrées de PATH doivent être des répertoires.

   

Pour PortableGit, l’emplacement peut se trouver sous C:\Users\<user>\AppData\Local\GitHub\PortableGit_<guid>. Vérifiez l’installation réelle sur votre ordinateur, puis ajoutez son répertoire cmd. Ajoutez son répertoire bin uniquement lorsque vous avez besoin des utilitaires supplémentaires qu’il contient.

Ajouter Git à PATH avec PowerShell

PowerShell peut enregistrer de façon persistante un répertoire dans votre PATH utilisateur sans remplacer les entrées existantes. L’exemple autonome suivant suppose que Git est installé à l’emplacement standard de Program Files. Il vérifie ce répertoire et l’ajoute uniquement s’il n’est pas déjà présent. Cet exemple spécifique à Windows n’a pas été exécuté dans les preuves d’exécution fournies ; vérifiez l’emplacement d’installation avant de l’utiliser.

$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')
    }
}

La cible User modifie le PATH persistant de votre compte ; elle ne requiert pas de fenêtre PowerShell élevée. Si Git est installé à un autre emplacement, définissez $gitCmd sur le répertoire cmd de cette installation. Modifier uniquement $env:Path n’affecte que le processus PowerShell actuel et ses processus enfants ; ce n’est donc pas un remplacement persistant de cette méthode.

Vérifier Git depuis un nouveau terminal

Fermez les fenêtres existantes de l’invite de commandes ou de PowerShell, ouvrez-en une nouvelle et exécutez git --version. Les nouveaux terminaux reçoivent l’environnement mis à jour ; un terminal déjà ouvert peut encore avoir son ancien PATH.

Si la commande affiche une version, Windows peut trouver Git par son nom. Cela confirme la découverte de la commande ; cela ne vérifie ni un dépôt ni votre configuration Git.

Dépannage lorsque Git n’est pas reconnu

Si un nouveau terminal signale que git n’est pas reconnu, vérifiez ces points :

• Vérifiez que Git est installé et que le répertoire cmd que vous avez ajouté existe. L’emplacement par défaut est généralement C:\Program Files\Git\cmd, mais un programme d’installation ou PortableGit peut en utiliser un autre.
• Dans les variables d’environnement, assurez-vous que le répertoire apparaît comme une entrée de Path. L’entrée doit se terminer par cmd, et non par git.exe.
• Ouvrez un autre nouveau terminal après avoir enregistré le changement. Les fenêtres existantes ne rechargent pas PATH automatiquement.
• Si vous avez modifié le Path système, vérifiez que le changement a été enregistré avec une autorisation d’administrateur. Pour un seul compte, utilisez plutôt le Path utilisateur.

Une fois le bon répertoire dans PATH, git --version dans un nouveau terminal devrait afficher la version installée.