Comment vérifier votre version de Python : Méthodes en ligne de commande et par scripts

Name

Rajiv Chandra

Publié le 19/08/2023

Mis à jour le 13/07/2026

Pour connaître la version de Python installée sur votre machine, ouvrez un terminal et tapez :

python --version

Si la commande affiche quelque chose comme Python 3.12.4, vous avez votre réponse. Si elle échoue ou renvoie Python 2, essayez python3 --version (macOS/Linux) ou py --version (Windows). C'est tout — le reste de ce guide détaille les différences selon le système, la vérification depuis un script Python, et la solution à l'erreur « 'python' n'est pas reconnu en tant que commande interne ».

Comment connaître la version de Python installée ?

Tout dépend d'où vous vous trouvez. Voici la commande à utiliser dans chaque situation :

Vérifier la version de Python en ligne de commande (cmd, PowerShell, terminal)

Sous Windows : l'invite de commandes (cmd) ou PowerShell

Ouvrez l'invite de commandes (tapez cmd dans le menu Démarrer) ou PowerShell, puis exécutez :

py --version

Le lanceur py est installé par l'installateur officiel de Windows et trouve vos versions de Python même si elles ne figurent pas dans le PATH. La commande python --version fonctionne aussi, à condition d'avoir coché l'ajout au PATH lors de l'installation. Pour lister toutes les versions installées sur la machine :

py -0

Sous macOS

python3 --version

Sur macOS, la commande python seule n'existe plus sur les versions récentes du système (elle pointait historiquement vers le Python 2 fourni par Apple). Prenez l'habitude de taper python3.

Sous Linux (Ubuntu, Debian, Fedora...)

python3 --version

Toutes les distributions modernes fournissent python3. La présence de la commande python dépend de la distribution : sous Ubuntu, elle n'existe que si le paquet python-is-python3 est installé.

La version d'un environnement virtuel activé

Dans un environnement virtuel (venv ou conda) activé, python --version renvoie toujours la version de cet environnement, qui peut différer du Python du système :

python --version

which python

Sous Windows, remplacez which python par where python. Si un paquet exige « Python ≥ 3.10 » et que votre code échoue quand même, vérifiez la version de l'environnement qui exécute réellement le code, pas celle du Python par défaut du système.

Connaître la version de Python dans un script

Utilisez sys.version_info quand votre code doit prendre une décision, et platform.python_version() quand vous voulez simplement une chaîne propre à afficher :

import sys
 
print(sys.version)        # chaîne complète, ex. '3.12.4 (main, ...) [GCC 13.2]'
print(sys.version_info)   # tuple structuré : sys.version_info(major=3, minor=12, ...)

import platform
 
print(platform.python_version())   # '3.12.4'

Exiger une version minimale

sys.version_info est un tuple, il se compare donc naturellement :

import sys
 
# Arrêter le script si la version de Python est trop ancienne
if sys.version_info < (3, 10):
    raise SystemExit("Ce script nécessite Python 3.10 ou plus récent")

C'est ce schéma que les projets modernes utilisent à la place de l'ancien branchement Python 2 / Python 3 : Python 2 a atteint sa fin de vie en 2020, un nouveau code doit simplement exiger une version 3.x minimale.

« 'python' n'est pas reconnu en tant que commande interne » : que faire ?

Si python --version renvoie cette erreur (ou « command not found » sous macOS/Linux), cela signifie que le shell ne trouve pas d'exécutable Python — pas forcément que Python n'est pas installé.

1. Essayez d'abord les alternatives : python3 --version (macOS/Linux) ou py --version (Windows).
2. Windows : si py fonctionne mais pas python, Python n'a pas été ajouté au PATH lors de l'installation. Relancez l'installateur et cochez « Add python.exe to PATH », ou utilisez simplement py.
3. Attention au raccourci Microsoft Store : sous Windows, taper python sans installation ouvre le Microsoft Store. Si py --version échoue aussi, Python n'est réellement pas installé.
4. macOS/Linux : si python3 manque également, installez-le depuis python.org (opens in a new tab), via Homebrew (brew install python) ou le gestionnaire de paquets de votre distribution.

Vérifier la version d'un paquet ou d'une bibliothèque avec pip

Bien souvent, la question de version porte en réalité sur une bibliothèque, pas sur l'interpréteur. Pour n'importe quel paquet installé :

pip show numpy

Ou depuis Python (fonctionne pour la plupart des paquets modernes) :

import numpy
 
print(numpy.__version__)

Pour un aperçu de tout ce qui est installé dans l'environnement courant, utilisez pip list.

Pourquoi vérifier sa version de Python ?

• Compatibilité des paquets — des bibliothèques comme NumPy et Pandas abandonnent régulièrement les anciennes versions de Python ; sur un interpréteur trop ancien, l'installation échoue ou résout silencieusement vers une vieille version.
• Syntaxe disponible — les instructions match demandent 3.10+, les annotations de type modernes comme list[int] demandent 3.9+, les f-strings 3.6+.
• Plusieurs interpréteurs cohabitent — le Python du système, les versions pyenv/conda et les venvs de chaque projet peuvent répondre à des commandes différentes : c'est l'origine classique des bugs « pourtant ça marche dans mon terminal ».

Si votre version s'avère trop ancienne, consultez comment mettre à jour Python — et adoptez un environnement virtuel par projet pour que les mises à jour cessent d'être des événements globaux.

FAQ

Comment connaître la version de Python installée ?

Ouvrez un terminal et exécutez python --version. Si la commande échoue, essayez python3 --version sous macOS/Linux ou py --version sous Windows.

Comment vérifier la version de Python avec cmd sous Windows ?

Ouvrez l'invite de commandes (cmd) et tapez py --version ou python --version. Le lanceur py fonctionne même si Python n'est pas dans le PATH.

Pourquoi python --version et python3 --version affichent-ils des versions différentes ?

Ce sont deux exécutables distincts : python et python3 peuvent pointer vers des interpréteurs installés côte à côte. Utilisez which python (macOS/Linux) ou where python (Windows) pour voir quel fichier répond à chaque commande.

Que faire si 'python' n'est pas reconnu ?

Le shell ne trouve pas d'exécutable Python dans le PATH. Essayez d'abord python3 --version ou py --version. Sous Windows, relancer l'installateur en cochant « Add python.exe to PATH » corrige la commande python.

Comment vérifier la version de Python dans un script ?

Utilisez le module sys : sys.version donne la chaîne complète, et sys.version_info un tuple comparable, par exemple if sys.version_info < (3, 10): pour exiger une version minimale.

Guides associés

• Comment mettre à jour Python vers la dernière version
• Les environnements virtuels Python expliqués
• Qu'est-ce que __pycache__ en Python ?

Vous explorez des dataframes dans un notebook ? PyGWalker (GitHub (opens in a new tab)) est une bibliothèque Python open source qui transforme votre dataframe pandas ou polars en interface d'exploration visuelle façon Tableau — un import, zéro code de tracé.