Table des matières
Open Table des matières
- À exécuter en tant qu’administrateur
- Voir tous les chemins Python
C’est quoi le PATH Windows, concrètement ?
Le PATH (ou %PATH% en langage Windows), c’est une variable d’environnement système qui contient une liste de dossiers. Quand tu tapes une commande dans PowerShell ou CMD, Windows cherche l’exécutable correspondant dans tous ces dossiers, dans l’ordre.
Exemple concret :
echo $env:PATH
C:\Windows\System32;C:\Program Files\Git\cmd;C:\Python311;C:\Users\Brandon\AppData\Local\Programs\Python\Python311\Scripts
Chaque chemin est séparé par un ;. Si tu tapes python, Windows va chercher python.exe dans :
C:\Windows\System32→ pas trouvéC:\Program Files\Git\cmd→ pas trouvéC:\Python311→ BINGO ! Il lance Python.
💡 À savoir : Si le programme n’est dans aucun de ces dossiers, Windows te balance un 'commande' n'est pas reconnu.... D’où l’intérêt d’ajouter le bon chemin au PATH.
Pourquoi ajouter un programme au PATH ?
Imagine que tu installes Python dans C:\Python311. Sans l’ajouter au PATH :
- ❌ Tu dois taper
C:\Python311\python.exe script.pyà chaque fois (pénible) - ❌ Impossible d’utiliser
pip installdirectement - ❌ Tes scripts ne fonctionnent pas dans n’importe quel dossier
Avec le PATH configuré :
- ✅ Tu tapes juste
python script.pyde n’importe où - ✅
pip,node,git, tout fonctionne en une commande - ✅ Tu gagnes du temps et tu évites les frustrations
C’est comme avoir un assistant qui sait exactement où chercher tes outils, sans que tu aies à lui donner l’adresse complète à chaque fois.
PATH utilisateur vs PATH système : quelle différence ?
Windows propose deux PATH distincts :
PATH utilisateur
- 🔹 Accessible uniquement pour ton compte Windows
- 🔹 Modifiable sans droits administrateur
- 🔹 Parfait pour tes outils perso (Python, Node, VS Code)
PATH système
- 🔹 Accessible pour tous les utilisateurs de la machine
- 🔹 Nécessite des droits administrateur
- 🔹 Utilisé pour les outils partagés (Git, Docker, outils d’entreprise)
⚠️ Erreur fréquente : Ajouter au PATH utilisateur alors que tu veux que tous les comptes puissent utiliser le programme. Choisis en fonction de ton besoin.
Méthode 1 : Interface graphique (la méthode simple)
C’est la méthode classique, celle que ton formateur en école d’admin sys t’a montrée en 2015. Elle fonctionne toujours en 2025.
Étape 1 : Ouvrir les variables d’environnement
Option A (rapide) :
- Appuie sur
Win + R - Tape
sysdm.cplet valide - Onglet Avancé → bouton Variables d’environnement
Option B (recherche) :
- Tape
pathdans la barre de recherche Windows - Clique sur Modifier les variables d’environnement système
- Bouton Variables d’environnement
Étape 2 : Modifier le PATH
Tu vas voir deux sections :
- Variables utilisateur (en haut)
- Variables système (en bas)
Pour modifier le PATH utilisateur :
- Sélectionne
Pathdans la section Variables utilisateur - Clique sur Modifier
- Clique sur Nouveau
- Colle le chemin de ton programme, par exemple :
C:\Program Files\Python311 - Clique sur OK partout jusqu’à tout fermer
Pour modifier le PATH système :
- Même chose, mais dans la section Variables système (nécessite des droits admin)
Étape 3 : Redémarrer ton terminal
IMPORTANT : Les modifications du PATH ne s’appliquent qu’aux nouveaux processus. Ferme PowerShell/CMD et rouvre-le.
💡 Astuce : Pas besoin de redémarrer Windows, juste ton terminal.
Méthode 2 : PowerShell (la méthode de pro)
Si tu bosses en ligne de commande, cette méthode est 10x plus rapide. En plus, tu peux l’automatiser dans des scripts de déploiement.
Voir le PATH actuel
$env:PATH -split ';'
$env:PATH += “;C:\Program Files\Python311”
⚠️ Attention : Cette modification est temporaire et disparaît à la fermeture du terminal.
Ajouter au PATH utilisateur (permanent)
[Environment]::SetEnvironmentVariable(
"Path",
[Environment]::GetEnvironmentVariable("Path", "User") + ";C:\Program Files\Python311",
"User"
)
À exécuter en tant qu’administrateur
[Environment]::SetEnvironmentVariable( “Path”, [Environment]::GetEnvironmentVariable(“Path”, “Machine”) + “;C:\Program Files\Python311”, “Machine” )
Script PowerShell complet avec vérification
Voici un script qui vérifie si le chemin existe déjà avant de l’ajouter :
# Chemin à ajouter
$nouveauChemin = "C:\Program Files\Python311"
# Récupérer le PATH actuel
$pathActuel = [Environment]::GetEnvironmentVariable("Path", "User")
# Vérifier si le chemin existe déjà
if ($pathActuel -notlike "*$nouveauChemin*") {
# Ajouter le nouveau chemin
$nouveauPath = $pathActuel + ";$nouveauChemin"
[Environment]::SetEnvironmentVariable("Path", $nouveauPath, "User")
Write-Host "✅ Chemin ajouté avec succès : $nouveauChemin" -ForegroundColor Green
} else {
Write-Host "ℹ️ Le chemin existe déjà dans le PATH" -ForegroundColor Yellow
}
echo %PATH%
Ajouter temporairement
set PATH=%PATH%;C:\Program Files\Python311
setx PATH “%PATH%;C:\Program Files\Python311”
⚠️ Attention avec setx : Il y a une limite de 1024 caractères. Si ton PATH est déjà bien rempli, utilise plutôt PowerShell ou l’interface graphique.
Cas d’usage concrets : Python, Node, Git, VS Code
🐍 Python
Après installation de Python, ajoute ces deux chemins :
C:\Python311
C:\Python311\Scripts
python —version pip —version
🟢 Node.js
Généralement, l’installeur ajoute Node au PATH automatiquement. Sinon :
C:\Program Files\nodejs
node —version npm —version
🔧 Git
Même chose, installeur automatique. Si besoin :
C:\Program Files\Git\cmd
git —version
💻 VS Code (command code)
Pour ouvrir des dossiers avec code . :
C:\Users\TonNom\AppData\Local\Programs\Microsoft VS Code\bin
code —version
🐳 Docker Desktop
C:\Program Files\Docker\Docker\resources\bin
python —version
Si ça affiche la version, c’est bon.
Méthode 2 : Vérifier que le chemin est dans le PATH
$env:PATH -split ';' | Select-String "Python"
Get-Command python
Ça affiche le chemin complet de python.exe utilisé.
Troubleshooting : quand ça ne marche pas
❌ Problème 1 : « La commande n’est toujours pas reconnue »
Causes possibles :
- Tu n’as pas fermé/rouvert ton terminal
- Le chemin contient une faute de frappe
- L’exécutable n’existe pas à cet emplacement
Solution :
# Vérifie que le fichier existe
Test-Path "C:\Program Files\Python311\python.exe"
Voir tous les chemins Python
$env:PATH -split ’;’ | Select-String “Python”
Supprime l’ancienne version du PATH si tu ne l’utilises plus.
Bonnes pratiques à connaître
✅ 1. Utilise des chemins sans espaces si possible
Préfère C:\Python311 à C:\Program Files\Python 3.11 (même si ça fonctionne).
✅ 2. Vérifie avant d’ajouter
Ne duplique pas un chemin déjà présent. Utilise le script PowerShell avec vérification (voir plus haut).
✅ 3. Documente tes modifications
Si tu gères un serveur, note quelque part les chemins ajoutés manuellement. Pratique pour les collègues qui reprennent derrière toi.
✅ 4. Préfère le PATH utilisateur quand c’est possible
Moins de risques de casser quelque chose pour les autres utilisateurs.
✅ 5. Fais une sauvegarde du PATH avant modifs importantes
$env:PATH > C:\Backup\PATH_backup.txt