Comment vérifier la version de Python : Windows, macOS et Linux

Il est plus important qu'il n'y paraît de connaître la version de Python que vous utilisez. De nombreuses bibliothèques et frameworks dépendent de versions spécifiques de Python, et le code peut se comporter différemment d'une version à l'autre. L'exécution de scripts sur une version non prise en charge ou inattendue entraîne souvent des échecs d'installation ou des erreurs d'exécution difficiles à diagnostiquer.

Dans ce guide, je vais vous présenter des méthodes simples et fiables pour vérifier votre version de Python sur les systèmes d'exploitation, environnements et configurations courants. Si vous débutez avec Python, je vous recommande de suivre notre cours d'introduction à Python, qui couvre des compétences telles que les types de données, les listes, les fonctions de base et les paquets.

Comment vérifier la version de Python à partir de la ligne de commande

La méthode la plus courante pour vérifier la version de Python consiste à utiliser le terminal de votre ordinateur (Mac/Linux) ou l'invite de commande/PowerShell (Windows).

Utilisation de Python --version

Cette commande demande au système quel interpréteur Python est associé à la commande python et affiche sa version.

python --version

Cette commande fonctionne sur la plupart des systèmes si python est correctement configuré dans votre PATH. Cependant, la commande peut échouer si python pointe vers Python 2 ou n'existe pas dans le PATH.

Utilisation de python3 --version

Certains systèmes, notamment macOS et Linux, exigent l'utilisation de ` python3 ` pour référencer explicitement Python 3. En effet, la plupart des ordinateurs modernes sont équipés à la fois de Python 2 et de Python 3.

python3 --version

Sous Windows, cette commande peut ne pas fonctionner à moins que Python n'ait été installé avec l'option python3 explicitement ajoutée.

Utilisation de Python -V (syntaxe alternative)

Cette commande est une version abrégée de « python --version ».

python -V

La commande produit le même résultat, mais se comporte de manière légèrement différente dans certains environnements. Dans certains environnements plus anciens ou certains shells spécifiques, le numéro de version peut être envoyé vers stderr (sortie d'erreur standard) au lieu de stdout (sortie standard).

À l'œil nu, cela semble identique à l'écran, mais cela peut avoir son importance dans les scripts si vous essayez de « transférer » ce texte vers un autre fichier ou programme.

Comment vérifier la version de Python à l'intérieur de Python

Il peut parfois être nécessaire de vérifier la version de Python à partir d'un script ou d'une session interactive. Cette fonctionnalité est utile lorsque vous souhaitez que votre code vérifie son environnement d'exécution afin de faciliter le débogage de votre script.

Vous pouvez accéder aux détails de la version en important la bibliothèque intégrée sys. Le code ci-dessous affiche la chaîne de caractères complète de la version Python ainsi que les détails de compilation.

-- Check Python version
import sys
print(sys.version)

Cette méthode est utile pour écrire une logique conditionnelle qui dépend de la version de Python et pour enregistrer des informations d'exécution.

Vérification de la version Python dans les environnements virtuels

Étant donné que les environnements virtuels (venv et conda) sont utilisés pour des projets spécifiques, ils peuvent employer une version de Python différente de celle installée par défaut sur votre système. Lorsque vous créez un environnement virtuel, celui-ci est fourni avec un interpréteur Python spécifique, et l'activation de l'environnement détermine quel exécutable Python est utilisé.

Pour vérifier la version Python active dans votre environnement virtuel, veuillez d'abord l'activer, puis exécuter la commande suivante :

python --version

Si la version qui s'affiche ne correspond pas à celle attendue, il est possible que l'environnement ait été créé avec une installation Python différente ou qu'il ne soit pas actuellement activé.

Je vous recommande d'utiliser notre fiche de référence Conda lorsque vous souhaitez obtenir un aperçu de la gestion des paquets et du fonctionnement de l'environnement conda.

Comment vérifier la version de Python sur différents systèmes d'exploitation

Chaque système d'exploitation gère Python de manière légèrement différente. Voici comment vérifier la version de Python dans chaque cas :

Windows

Pour vérifier la version de Python sous Windows, veuillez utiliser :

python --version

Ou :

py --version

Les inconvénients de cette méthode sont que plusieurs installations Python peuvent entraîner une certaine confusion, ou que l'python e peut ne pas être reconnue en raison d'une mauvaise configuration du PATH. De plus, le lanceur py peut pointer vers une version différente de celle de python, ce qui peut entraîner un échec.

macOS et Linux

Pour macOS et Linux, il est important de noter que le système peut inclure une version préinstallée de Python utilisée en interne par le système d'exploitation. De plus, python peut faire référence à Python 2 ou ne pas exister du tout, tandis que python3 pointe généralement vers la version Python 3 installée par l'utilisateur.

Vous pouvez vérifier la version de Python sous macOS ou Linux en utilisant :

python --version

Ou utilisez python3 pour éviter d'utiliser accidentellement une version obsolète ou gérée par le système de Python.

python3 --version

Problèmes courants lors de la vérification de la version Python

Lors de la vérification de la version Python, vous pourriez rencontrer une certaine confusion, en particulier lorsque plusieurs outils et environnements sont impliqués :

• « Commande Python introuvable » : Cela signifie généralement que Python n'est pas installé ou qu'il n'est pas ajouté au PATH de votre système. Sur certains systèmes, seul python3 est disponible, et non python.

• Plusieurs versions de Python sont installées : Il est courant d'avoir plusieurs versions de Python sur la même machine. Différentes commandes telles que python, python3 et py peuvent pointer vers différents interpréteurs, ce qui peut rendre les vérifications de version incohérentes.

• La commande renvoie une version inattendue : Il est possible que vous vérifiiez une installation Python différente de celle que vous aviez prévue. Cela se produit souvent lorsque l'environnement virtuel n'est pas activé ou lorsque l'ordre PATH donne la priorité à un autre exécutable Python.

• Incompatibilité entre la version de l'IDE et celle du terminal : Votre IDE, tel que VS Code ou PyCharm, peut être configuré pour utiliser un interpréteur Python différent de celui de votre terminal. Le code exécuté dans l'IDE utilise l'interpréteur configuré et peut ne pas être nécessairement celui renvoyé par la commande « python --version » dans votre ligne de commande.

Meilleures pratiques pour la gestion des versions Python

Afin d'éviter toute surprise liée à la version, je recommande d'utiliser la liste de contrôle ci-dessous :

• Veuillez toujours vérifier la version de Python avant d'installer les dépendances : Veuillez toujours exécuter la commande « python --version » avant d'exécuter une commande telle que « pip install ». Cela garantit que vous n'installez pas accidentellement des bibliothèques dans la mauvaise version.

• Soyez explicite dans vos commandes : Si vous savez que vous avez besoin de Python 3, veuillez utiliser python3 au lieu de supposer que python pointe vers la bonne version.

• Utilisez systématiquement des environnements virtuels : Veuillez utiliser un environnement virtuel (venv) pour chaque nouveau projet. Cela permet d'isoler la version et les bibliothèques de votre projet du reste de votre système afin de garantir que chacune utilise la version Python et les dépendances appropriées.

• Évitez de dépendre du système Python pour vos projets : Le Python géré par le système est fréquemment utilisé par le système d'exploitation et il est recommandé de ne pas le modifier. Veuillez toujours installer votre propre version de Python pour vos projets afin d'obtenir les résultats escomptés.

Conclusion

Préciser la version de Python que vous utilisez vous permet d'éviter les problèmes de configuration courants, réduit la confusion et vous fait gagner du temps lors de l'installation de paquets ou du débogage d'erreurs.

Pour une compréhension approfondie de Python, vous pouvez approfondir vos connaissances grâce à notre Python Data Fundamentals et Python Programming Fundamentals skill tracks. Enfin, je recommande personnellement notre parcours de développeur Python cursus pour acquérir des connaissances sur le test de code et le contrôle de version dans le domaine du web scraping et du développement de paquets.