Ajouter Python au PATH sous Windows 11 et 10 : guide complet

Quand Windows affiche un message du type python n'est pas reconnu en tant que commande interne ou externe, le probleme ne vient pas forcement de Python. Le plus souvent, Python est installe, mais Windows ne sait pas dans quel dossier chercher l’executable python.exe.

La solution consiste a ajouter Python au PATH, c’est-a-dire a la liste des dossiers que Windows parcourt quand vous tapez une commande dans PowerShell, le terminal Windows ou l’invite de commandes.

La methode la plus simple est de cocher l’option Add python.exe to PATH au moment de l’installation depuis python.org. Si Python est deja installe, vous pouvez aussi ajouter manuellement les deux dossiers importants : le dossier de Python et le dossier Scripts, qui contient notamment pip.

python --version
python -m pip --version

Si ces deux commandes repondent avec une version, Python est correctement accessible depuis le terminal.

La reponse courte

Pour ajouter Python au PATH sous Windows 11 ou Windows 10 :

1. Ouvrez le menu Demarrer et cherchez variables d'environnement.
2. Cliquez sur les variables d’environnement de votre compte utilisateur.
3. Modifiez la variable Path.
4. Ajoutez le dossier qui contient python.exe.
5. Ajoutez aussi le dossier Scripts.
6. Fermez puis rouvrez le terminal.
7. Verifiez avec python --version et python -m pip --version.

Les chemins ressemblent souvent a ceci :

C:\Users\VotreNom\AppData\Local\Programs\Python\Python313\
C:\Users\VotreNom\AppData\Local\Programs\Python\Python313\Scripts\

Le nom Python313 depend de votre version. Sur une autre machine, ce dossier peut s’appeler Python312, Python314 ou autre. Le principe reste le meme : ajoutez le dossier qui contient python.exe, pas le fichier python.exe lui-meme.

A quoi sert le PATH sous Windows ?

Le PATH est une variable d’environnement. Elle contient une liste de dossiers separes par Windows. Quand vous tapez une commande comme python, pip, git ou node, Windows cherche un executable portant ce nom dans les dossiers du PATH.

Si le dossier de Python n’est pas dans cette liste, Windows peut repondre :

python n'est pas reconnu en tant que commande interne ou externe

ou, en anglais :

'python' is not recognized as an internal or external command

Cela ne veut pas toujours dire que Python est absent. Cela signifie surtout que le terminal ne trouve pas Python depuis l’endroit ou il cherche.

Installer Python en cochant l’option PATH

Si vous n’avez pas encore installe Python, la methode la plus propre est de le faire directement avec l’installateur officiel.

Telechargez Python depuis le site officiel, lancez l’installation, puis cochez l’option qui ajoute python.exe au PATH. Elle apparait generalement dans la premiere fenetre de l’installateur.

Apres l’installation, ouvrez un nouveau terminal et testez :

python --version

Puis :

python -m pip --version

Pourquoi utiliser python -m pip plutot que seulement pip ? Parce que cette commande lance pip avec l’interpreteur Python que vous venez d’appeler. C’est plus fiable quand plusieurs versions de Python sont installees.

Ajouter Python au PATH manuellement

Si Python est deja installe, vous n’avez pas besoin de tout supprimer. Vous pouvez modifier la variable Path.

Trouver le bon dossier Python

Commencez par chercher ou Python est installe. Les installations par utilisateur se trouvent souvent ici :

C:\Users\VotreNom\AppData\Local\Programs\Python\

Dans ce dossier, vous verrez un sous-dossier de version, par exemple :

Python312
Python313
Python314

Le dossier a ajouter est celui qui contient python.exe :

C:\Users\VotreNom\AppData\Local\Programs\Python\Python313\

Ajoutez aussi le dossier Scripts :

C:\Users\VotreNom\AppData\Local\Programs\Python\Python313\Scripts\

Le premier permet d’utiliser python. Le second permet d’utiliser les outils installes avec Python, dont pip et parfois des commandes de bibliotheques comme black, pytest, jupyter ou uv.

Modifier la variable Path

Sous Windows 11 comme sous Windows 10, la logique est la meme :

1. Ouvrez le menu Demarrer.
2. Cherchez variables d'environnement.
3. Ouvrez la fenetre des proprietes systeme avancees.
4. Cliquez sur Variables d'environnement.
5. Dans les variables utilisateur, selectionnez Path.
6. Cliquez sur modifier.
7. Ajoutez les deux chemins Python.
8. Validez toutes les fenetres.
9. Fermez puis rouvrez PowerShell ou le terminal Windows.

Pour un ordinateur personnel, privilegiez la variable Path de votre utilisateur. C’est suffisant dans la plupart des cas et cela evite de modifier la configuration globale de la machine.

La variable Path systeme s’applique a tous les comptes Windows. Elle est utile sur une machine partagee, dans un poste administre ou quand Python est installe dans C:\Program Files\..., mais elle demande souvent des droits administrateur.

Verifier que Windows utilise le bon Python

Apres modification du PATH, fermez toutes les fenetres de terminal ouvertes, puis ouvrez-en une nouvelle.

Dans PowerShell, testez :

python --version

Puis :

python -m pip --version

Pour savoir quel executable est utilise, tapez :

where.exe python

PowerShell possede aussi une commande utile :

Get-Command python

Si plusieurs chemins apparaissent, Windows utilise generalement le premier dans la liste. L’ordre du PATH peut donc changer la version de Python appelee par defaut.

Comprendre la difference entre python, py et pip

Sous Windows, trois commandes reviennent souvent : python, py et pip. Elles n’ont pas exactement le meme role.

Pour lister les versions reperees par le lanceur Python :

py -0p

Pour lancer une version precise :

py -3.13 --version

Dans un guide pour debuter, retenez surtout cette regle :

python -m pip install nom_du_paquet

Elle evite beaucoup d’erreurs, car pip est appele depuis le Python actif.

Corriger l’erreur “python n’est pas reconnu”

Si python --version ne fonctionne pas, verifiez dans cet ordre.

Le terminal n’a pas ete redemarre

Les terminaux deja ouverts ne recuperent pas toujours les nouvelles variables d’environnement. Fermez PowerShell, l’invite de commandes, le terminal Windows et votre editeur de code, puis ouvrez une nouvelle session.

Le mauvais dossier a ete ajoute

Le PATH doit contenir le dossier, pas le fichier :

Correct :
C:\Users\VotreNom\AppData\Local\Programs\Python\Python313\

Incorrect :
C:\Users\VotreNom\AppData\Local\Programs\Python\Python313\python.exe

Le dossier Scripts manque

Si python --version fonctionne mais pas pip --version, le dossier Scripts manque probablement dans le PATH.

Ajoutez :

C:\Users\VotreNom\AppData\Local\Programs\Python\Python313\Scripts\

Puis testez :

python -m pip --version

Meme si la commande pip seule ne fonctionne pas encore, python -m pip peut deja fonctionner.

Windows ouvre le Microsoft Store

Sur certaines installations, taper python peut ouvrir le Microsoft Store au lieu de lancer Python. Cela arrive quand les alias d’execution python.exe ou python3.exe de Windows prennent la main.

Dans ce cas :

1. Installez Python depuis python.org si ce n’est pas deja fait.
2. Verifiez que le dossier Python est bien dans le PATH.
3. Dans les parametres Windows, cherchez les alias d’execution d’application.
4. Desactivez les alias python.exe et python3.exe s’ils redirigent vers le Store.
5. Rouvrez le terminal.

Vous pouvez ensuite verifier avec :

where.exe python

Le resultat doit pointer vers votre dossier Python, pas seulement vers un alias Windows.

Plusieurs versions de Python sont installees

Il est courant d’avoir plusieurs versions installees : une version installee depuis python.org, une version ajoutee par un outil, une version dans un environnement virtuel, ou une version fournie par le Microsoft Store.

Dans ce cas, inspectez l’ordre des executables :

where.exe python
py -0p

Si vous voulez utiliser une version precise, le lanceur py est souvent plus explicite :

py -3.13 script.py

Si vous travaillez dans un projet, la meilleure solution reste souvent de creer un environnement virtuel.

PATH global ou environnement virtuel : ne pas confondre

Ajouter Python au PATH sert a rendre Python accessible depuis le terminal. Cela ne remplace pas un environnement virtuel.

Un environnement virtuel isole les dependances d’un projet. C’est utile si un projet utilise numpy, un autre pandas, et un troisieme une version differente d’une meme bibliotheque.

Exemple :

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install requests

Une fois l’environnement active, la commande python pointe vers le Python de .venv, et non plus directement vers l’installation globale.

Ce comportement est normal. Il permet a chaque projet de garder ses propres paquets.

Commandes utiles a garder sous la main

Si vous debutez, ces commandes suffisent pour diagnostiquer la majorite des problemes d’installation Python sous Windows.

Exemple complet apres une installation propre

Voici une sequence simple pour verifier une installation recente :

python --version
python -m pip --version
where.exe python
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install requests
python -c "import requests; print(requests.__version__)"

Cette sequence verifie quatre choses :

1. Python est accessible.
2. pip fonctionne avec ce Python.
3. Windows pointe vers le bon executable.
4. Un environnement virtuel peut installer et importer un paquet.

Si tout passe, votre configuration est suffisamment propre pour commencer a travailler.

Faut-il ajouter pip directement au PATH ?

Il est utile d’ajouter le dossier Scripts, car il contient pip.exe et les executables de certains outils Python. Mais dans la pratique, utilisez souvent :

python -m pip install nom_du_paquet

Cette syntaxe est plus robuste que :

pip install nom_du_paquet

La difference devient importante quand plusieurs Python sont installes. pip peut appartenir a une version, tandis que python peut en appeler une autre. Avec python -m pip, vous reduisez ce risque.

Les erreurs les plus frequentes

Ajouter un chemin d’une ancienne version

Si vous avez des dossiers Python310, Python312 et Python313, verifiez celui que vous voulez utiliser. Un vieux chemin place avant le nouveau dans le PATH peut lancer une version inattendue.

Modifier les variables systeme sans raison

Sur un PC personnel, modifier les variables utilisateur suffit souvent. Les variables systeme sont plus sensibles, car elles touchent tous les comptes.

Oublier le dossier Scripts

Python peut fonctionner alors que pip, pytest ou jupyter restent introuvables. Dans ce cas, ajoutez le dossier Scripts.

Croire que le PATH installe Python

Le PATH ne fait que dire a Windows ou chercher une commande. Si Python n’est pas installe, ajouter un chemin invente ne servira a rien.

Melanger installation globale et projet

Installez Python globalement une fois, puis creez des environnements virtuels pour vos projets. C’est plus propre que d’empiler toutes les bibliotheques dans la meme installation.

Pour aller plus loin avec Python

Une fois Python correctement accessible depuis le terminal, vous pouvez commencer a travailler avec des scripts, des bibliotheques et des algorithmes.

Pour progresser sur les bases utiles, vous pouvez lire aussi :

• Complexite algorithmique en Python : comprendre O(n), O(log n) et O(n²)
• Algorithmes de graphes en Python : le guide pour bien demarrer
• np.pad / numpy.pad : ajouter du padding a un tableau NumPy

La bonne configuration Windows n’est pas une fin en soi. Elle doit surtout vous permettre d’executer un script, d’installer une bibliotheque, de creer un environnement virtuel et de reproduire votre travail sans perdre du temps sur les erreurs de terminal.

References

• Documentation Python officielle : Using Python on Windows
• Python Packaging User Guide : Installing Python packages
• Microsoft Learn : Environment Variables