Installer et vérifier Python

Ce que vous saurez faire

Installez Python, vérifiez quel Python votre terminal exécute et lancez votre premier script. Un ordinateur peut avoir plusieurs versions de Python. Beaucoup de problèmes chez les débutants surviennent quand la mauvaise version s’exécute.

Avant de commencerCe qu’il faut savoir et avoir sous la mainEnviron 30 minutes

Ce que vous devez savoir

• Les chemins, le répertoire de travail et les codes de sortie, vus dans Les fichiers et le terminal.

Ce qu’il vous faut sur votre ordinateur

• Le dossier ~/projects/ticket-cleaner. Vous l’avez créé dans Les fichiers et le terminal : exercice guidé. S’il manque, refaites cette section. Cela prend deux minutes.
• Un terminal où vous pouvez accéder à ce dossier avec cd ~/projects/ticket-cleaner, comme dans À vous de jouer : vous déplacer avec des chemins.
• La permission d’installer des logiciels sur votre ordinateur.
• Environ 200 Mo d’espace disque libre et une connexion Internet.

Testé avec Python 3.14 sur macOS, Windows (PowerShell) et Ubuntu 26.04. Toute version de Python à partir de 3.12 convient à ce cours.

Python est un programme qui exécute votre programme

Python est un langage de programmation, mais aussi un programme sur votre ordinateur. Ce programme est l’interpréteur. Il lit un fichier de code Python et exécute chaque ligne, du haut vers le bas.

Un programme Python dans un fichier est un script. Le nom du fichier se termine par .py. Pour exécuter un script, vous lancez l’interpréteur et lui donnez le nom du fichier comme argument :

python3 first_run.py

Un ordinateur possède souvent plusieurs interpréteurs. Par exemple, un Mac peut avoir un ancien Python d’Apple et le nouveau que vous installez. La commande que vous tapez (python3, python ou py) choisit l’un d’eux. Après avoir installé Python, vous vérifiez donc deux choses : la version et l’emplacement de l’interpréteur qui s’exécute.

Étape 1 : installer Python

Suivez les étapes pour votre système.

macOS

Attention

N’utilisez pas le python3 fourni avec macOS (/usr/bin/python3). Il est ancien, et Apple le conserve pour ses propres outils. Si une fenêtre vous demande d’installer les « command line developer tools » (outils de développement en ligne de commande), c’est le Python d’Apple. Installez plutôt la version de python.org.

1. Allez sur python.org/downloads.
2. Sélectionnez Download Python 3.14 (télécharger Python 3.14), ou la version la plus récente affichée sur la page.
3. Ouvrez le fichier .pkg téléchargé et suivez les étapes du programme d’installation. Gardez les options par défaut.
4. À la fin de l’installation, une fenêtre Finder s’ouvre avec un dossier Python 3.14. Double-cliquez sur Install Certificates.command (installer les certificats). Cela permet à Python de vérifier l’identité des sites Web sécurisés. Vous en aurez besoin au module 4.
5. Fermez toutes les fenêtres du terminal, puis ouvrez un nouveau terminal. Un terminal trouve les nouveaux programmes seulement au démarrage.

Windows

Sur Windows, vous installez d’abord le Python install manager (gestionnaire d’installation de Python). Il installe Python et vous fournit les commandes python et py.

1. Ouvrez l’application Microsoft Store.

2. Recherchez Python Install Manager (gestionnaire d’installation de Python), puis sélectionnez Get (obtenir) ou Install (installer). Si vous ne pouvez pas utiliser le Store, téléchargez le gestionnaire d’installation sur python.org/downloads.

3. Fermez toutes les fenêtres du terminal, puis ouvrez un nouveau terminal PowerShell.

4. Installez Python 3.14 :

   py install 3.14

5. Si le gestionnaire propose d’ajouter un dossier à votre PATH, tapez y et appuyez sur Entrée. PATH est la liste des dossiers où le terminal cherche les commandes.

6. Fermez le terminal, puis ouvrez-en un nouveau.

Remarque

Utilisez la commande python sur Windows, pas python3. Le gestionnaire d’installation fait en sorte que python lance le Python installé le plus récent.

Linux

La plupart des systèmes Linux incluent Python. Vérifiez d’abord la version :

python3 --version

Si la version est 3.12 ou plus récente, installez seulement les éléments supplémentaires utilisés dans ce cours. Si elle est plus ancienne, ou si la commande est introuvable, installez Python avec la même commande.

1. Sur Ubuntu ou Debian, exécutez :

   sudo apt update
   sudo apt install python3 python3-venv python3-pip

   Sur Fedora, exécutez sudo dnf install python3.

2. Tapez votre mot de passe quand le terminal le demande. Le terminal n’affiche rien pendant que vous tapez le mot de passe. C’est normal.

Attention

Ne supprimez pas et ne remplacez pas le Python du système sur Linux. Des éléments du système l’utilisent. Dans la prochaine leçon, vous donnerez à votre projet son propre environnement. Vous n’aurez donc jamais besoin de modifier le Python du système.

Étape 2 : vérifier quel Python s’exécute

Deux commandes répondent aux deux questions : quelle est sa version et où se trouve-t-il?

1. Affichez la version :

   macOS

   python3 --version

   Windows

   python --version

   Linux

   python3 --version

   Sortie

   Python 3.14.6

   Vos nombres peuvent être différents. Les deux premiers nombres doivent être 3.12 ou plus.

2. Affichez l’emplacement de l’interpréteur. L’option -c indique à Python d’exécuter le code entre guillemets plutôt qu’un fichier :

   macOS

   python3 -c "import sys; print(sys.executable)"

   Sortie

   /Library/Frameworks/Python.framework/Versions/3.14/bin/python3

   Windows

   python -c "import sys; print(sys.executable)"

   Sortie

   C:\Users\amira\AppData\Local\Python\pythoncore-3.14-64\python.exe

   Linux

   python3 -c "import sys; print(sys.executable)"

   Sortie

   /usr/bin/python3

   Sur macOS, le chemin ne doit pas être /usr/bin/python3. C’est l’ancien Python d’Apple.

Dans le reste de cette leçon, les commandes utilisent python3. Sur Windows, tapez plutôt python. À partir de la prochaine leçon, tout le monde tape python.

Étape 3 : obtenir un éditeur de code

Un éditeur de code est un programme pour écrire du code. Il colore le code pour faciliter la lecture et signale certaines erreurs avant l’exécution. Ce cours utilise Visual Studio Code (VS Code), qui est gratuit et fonctionne sur les trois systèmes. Si vous utilisez déjà un autre éditeur de code, vous pouvez le garder.

1. Téléchargez VS Code depuis code.visualstudio.com et installez-le.
2. Ouvrez VS Code. Sélectionnez l’icône Extensions (extensions) à gauche, représentée par quatre petits carrés.
3. Recherchez Python. Installez l’extension de Microsoft.
4. Sélectionnez File › Open Folder (fichier › ouvrir un dossier) et ouvrez votre dossier ticket-cleaner.
5. Sélectionnez Terminal › New Terminal (terminal › nouveau terminal). Un terminal s’ouvre au bas de la fenêtre, déjà dans le dossier ticket-cleaner.

Vous pouvez utiliser le terminal de VS Code ou une fenêtre de terminal séparée. Ils fonctionnent de la même façon.

Exemple détaillé : le premier script

Amira crée un script qui indique quel Python l’exécute. Dans VS Code, elle sélectionne File › New File (fichier › nouveau fichier). Elle l’enregistre sous le nom first_run.py dans ticket-cleaner, puis tape ce code :

first_run.py

import platform
import sys

print("ticket-cleaner: first run")
print("Python version:", platform.python_version())
print("Interpreter:", sys.executable)

Ligne par ligne :

Ligne	Ce qu’elle fait
import platform et import sys	Chargent deux éléments de code prêt à utiliser de Python. platform connaît la version de Python. sys sait où se trouve l’interpréteur.
print(...)	Affiche du texte dans le terminal. Chaque print produit une ligne de sortie.
"ticket-cleaner: first run"	Le texte entre guillemets s’affiche exactement comme vous l’avez écrit (« ticket-cleaner : première exécution »).
platform.python_version()	Obtient le numéro de version, par exemple 3.14.6. print l’affiche après le texte, avec une espace entre les deux.

Elle l’exécute depuis le dossier du projet :

Terminal

cd ~/projects/ticket-cleaner
python3 first_run.py

Output (macOS)

ticket-cleaner: first run
Python version: 3.14.6
Interpreter: /Library/Frameworks/Python.framework/Versions/3.14/bin/python3

Puis elle vérifie le code de sortie, comme dans la leçon précédente :

macOS

echo $?

Windows

$LASTEXITCODE

Linux

echo $?

Sortie

0

Le script s’est terminé sans erreur, donc Python a donné le code de sortie 0.

Exercice guidé : exécuter votre premier script

1. Dans VS Code, créez un fichier. Enregistrez-le sous le nom first_run.py dans votre dossier ticket-cleaner.

2. Tapez le code de l’exemple détaillé. Enregistrez le fichier avec Ctrl+S (Cmd+S sur macOS).

3. Dans le terminal, assurez-vous d’être dans le dossier du projet :

   pwd

   La sortie se termine par ticket-cleaner.

4. Exécutez le script :

   python3 first_run.py

   Vous voyez trois lignes. La version et le chemin de l’interpréteur sont les mêmes qu’à l’étape 2.

5. Affichez le code de sortie. Sur macOS et Linux, exécutez echo $?. Dans PowerShell, exécutez $LASTEXITCODE.

   La sortie est 0.

À vous de jouer : où le script s’exécute-t-il?

Ajoutez une ligne à la fin de first_run.py. Elle affiche le répertoire de travail que le programme voit :

first_run.py (add at the end)

import os
print("Working directory:", os.getcwd())

Exécutez le script deux fois. Avant chaque exécution, prédisez la dernière ligne de la sortie.

1. Depuis le dossier du projet : python3 first_run.py.
2. Depuis le dossier projects : exécutez cd .., puis python3 ticket-cleaner/first_run.py.

Afficher la réponse

La première exécution affiche .../projects/ticket-cleaner. La deuxième affiche .../projects. Le fichier du script reste au même endroit, mais le répertoire de travail est le dossier où se trouve le terminal. Quand un prochain script ouvrira data/tickets.csv, Python le cherchera à partir du répertoire de travail. Exécutez donc les scripts du projet depuis le dossier du projet.

Erreur courante

Impossible d'ouvrir le fichier

Symptôme : vous exécutez python3 first_run.py et voyez une erreur comme celle-ci. Le code de sortie est 2.

python3: can't open file '/Users/amira/first_run.py': [Errno 2] No such file or directory

Cause : Python cherche first_run.py dans le répertoire de travail. Le chemin dans le message montre où il a cherché : ici, le dossier personnel, et non ticket-cleaner. Si le chemin est correct, le nom du fichier peut être différent, par exemple first-run.py ou first_run.py.txt.

Solution :

1. Exécutez pwd. Si vous n’êtes pas dans ticket-cleaner, exécutez cd ~/projects/ticket-cleaner.
2. Exécutez ls. Vérifiez que first_run.py est dans la liste, avec exactement ce nom.
3. Exécutez le script de nouveau.

Erreur courante

Le mauvais Python s'exécute

Symptôme : l’un des cas suivants :

• Sur macOS, python3 --version affiche Python 3.9.6, ou sys.executable affiche /usr/bin/python3.
• Sur Windows, python ouvre le Microsoft Store ou affiche Python was not found (Python est introuvable).
• Sur n’importe quel système, python3: command not found (commande python3 introuvable).

Cause : le terminal a trouvé un autre Python, ou aucun Python, dans les dossiers de son PATH. Cela arrive souvent quand le terminal était ouvert pendant l’installation. Il ne connaît donc pas le nouveau programme.

Solution :

1. Fermez toutes les fenêtres du terminal, y compris le terminal de VS Code. Ouvrez-en un nouveau.
2. Exécutez de nouveau les deux commandes de l’étape 2.
3. Si le problème persiste sur macOS, relancez le programme d’installation de python.org.
4. Si le problème persiste sur Windows, ouvrez le menu Start (démarrer) et recherchez Manage app execution aliases (gérer les alias d’exécution des applications). Vérifiez que Python (default) (Python par défaut) et Python install manager sont sur On (activé). Ouvrez ensuite un nouveau terminal.

L'invite >>>

Si vous exécutez python3 sans nom de fichier, Python démarre en mode interactif. L’invite devient >>>. Vous tapez maintenant du code Python, pas des commandes de terminal. Tapez 2 + 3 et appuyez sur Entrée : Python affiche 5. Le mode interactif est utile pour tester rapidement une ligne. Pour revenir au terminal, tapez exit() et appuyez sur Entrée. Si vous tapez python3 first_run.py à l’invite >>>, vous obtenez SyntaxError: invalid syntax (erreur de syntaxe : syntaxe invalide). C’est une commande de terminal, pas du code Python.

Vérifiez votre compréhension

Votre terminal est dans ~/projects. Vous exécutez python3 ticket-cleaner/first_run.py. Est-ce que cela fonctionne? Qu'affiche la ligne Working directory (répertoire de travail)?

Afficher la réponse

Cela fonctionne, car ticket-cleaner/first_run.py est un chemin relatif correct depuis ~/projects. La dernière ligne affiche le dossier projects, car le répertoire de travail est le dossier du terminal, pas celui du script.

Vérifiez votre compréhension

Vérification pratique : affichez la version et l'emplacement du Python que votre terminal exécute. Comment savez-vous que ce n'est pas un ancien Python du système?

Afficher la réponse

Exécutez python3 --version (python --version sur Windows) et python3 -c "import sys; print(sys.executable)". La version est 3.12 ou plus récente. Sur macOS, l’emplacement n’est pas /usr/bin/python3. Sur Windows, l’emplacement est dans votre dossier utilisateur, sous AppData\Local\Python.

Récapitulatif

• L’interpréteur est le programme qui exécute le code Python. Un script est un fichier .py que vous exécutez avec python3 file.py.
• Un ordinateur peut avoir plusieurs versions de Python. Vérifiez la version avec --version et l’emplacement avec sys.executable.
• Un script voit le répertoire de travail du terminal, pas le dossier où il se trouve. Exécutez les scripts du projet depuis le dossier du projet.
• Un script qui se termine sans erreur donne le code de sortie 0.

Ensuite, vous donnerez au projet son propre environnement Python. Ainsi, les paquets dont il a besoin n’affecteront pas les autres projets.

Leçon suivante : Isoler les dépendances