Cours de Python / Écrire, exécuter et déboguer un script dans VS Code

Pour exécuter Python dans Visual Studio Code, vous devez disposer de l’éditeur, de l’extension Python et d’un interpréteur Python. Ouvrez le dossier du projet et sélectionnez son environnement virtuel afin que l’exécution et l’installation des paquets utilisent le même Python.

Préparer l’éditeur et ouvrir le projet

Ce guide suppose que Python est installé et qu’un dossier python-lab contient un environnement .venv. Les procédures pour Windows et pour macOS ou Ubuntu permettent de préparer cette base. Visual Studio Code, généralement appelé VS Code, est l’éditeur dans lequel vous écrivez les fichiers ; son installation ne fournit pas à elle seule l’interpréteur.

1. Installez VS Code depuis son site officiel, accessible dans le tutoriel Python de VS Code.
2. Ouvrez la vue Extensions et recherchez l’extension Python publiée par Microsoft. Vérifiez le nom et le fournisseur avant de l’installer.
3. Utilisez File → Open Folder — Fichier → Ouvrir le dossier dans une interface française — et choisissez python-lab. Ouvrez le dossier complet plutôt qu’un fichier isolé.

Le dossier ouvert devient l’espace de travail. Cela facilite la correspondance entre les fichiers visibles dans l’explorateur de VS Code, le dossier courant du terminal et les chemins relatifs de vos programmes. Les libellés des commandes peuvent varier selon la langue de l’interface ; les noms anglais ci-dessous permettent de reconnaître les commandes documentées.

Choisir l’interpréteur et contrôler les chemins

1. Ouvrez la palette de commandes avec Ctrl+Shift+P sous Windows ou Linux, et Cmd+Shift+P sous macOS.
2. Recherchez Python: Select Interpreter. Sélectionnez le Python du dossier .venv de ce projet. S’il n’apparaît pas, indiquez son chemin via l’option de saisie du chemin de l’interpréteur.
3. Ouvrez un nouveau terminal intégré depuis Terminal → New Terminal. Vérifiez l’interpréteur et pip avec les deux commandes suivantes.

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

Sur Windows, le premier chemin doit se terminer par .venv\Scripts\python.exe ; sur macOS et Ubuntu, il doit désigner .venv/bin/python. Le chemin indiqué par pip doit également appartenir au même environnement. Le texte exact dépend de l’emplacement de votre projet et de la version installée.

Un terminal déjà ouvert peut conserver l’environnement précédent. Après un changement d’interpréteur, créez donc un nouveau terminal et vérifiez les chemins au lieu de supposer que le choix a été répercuté partout. Si l’activation automatique n’a pas lieu, utilisez directement .\.venv\Scripts\python.exe sous Windows, ou .venv/bin/python sous macOS et Ubuntu, à la place de python.

Créer et exécuter un fichier complet

Dans l’explorateur de VS Code, créez expense.py à la racine de python-lab, à côté de .venv. Enregistrez en UTF-8 le programme complet suivant. Il ne demande aucun paquet supplémentaire.

amounts = [3500, 8000, 2500]
total = sum(amounts)
print(f"total={total}")

Enregistrez le fichier avec Ctrl+S ou Cmd+S. Utilisez la commande Run Python File in Terminal de l’extension Python, ou saisissez python expense.py dans le terminal du projet dont vous venez de vérifier l’environnement.

Le résultat attendu est :

total=14000

La liste amounts contient les trois montants. La fonction sum() calcule leur total ; la dernière instruction affiche ce total. Pour vérifier que vous exécutez bien le fichier modifié, remplacez 8000 par 9000, enregistrez et relancez : vous devez obtenir total=15000. Rétablissez ensuite 8000.

Avant de comparer une exécution normale à une session de débogage, vous pouvez refaire ce contrôle dans un nouveau terminal. Il doit toujours retrouver le même environnement :

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

Observer les variables avec le débogueur

Un débogueur permet de suspendre le programme pour examiner son état. Dans expense.py, cliquez dans la marge à gauche de la troisième ligne, celle de print(), pour poser un point d’arrêt. Cette position est importante : le calcul de total aura déjà été exécuté au moment de la pause.

1. Lancez le débogage avec F5 ou la vue Run and Debug. Si VS Code vous demande une configuration, choisissez le débogueur Python, puis l’exécution du fichier Python courant.
2. Quand l’exécution s’arrête sur print(), consultez la zone Variables. Vous devez retrouver amounts avec ses trois valeurs et total égal à 14000.
3. Utilisez Step Over, généralement associé à F10, pour exécuter l’instruction suivante. Comparez le résultat affiché à la valeur observée. Arrêtez la session et retirez le point d’arrêt en cliquant de nouveau dans la marge.

Selon le clavier, les touches de fonction peuvent demander l’utilisation de la touche Fn ; les commandes de la barre de débogage offrent les mêmes actions. Consultez les documentations officielles sur les environnements Python dans VS Code et le débogage Python pour les paramètres propres à votre installation.

• Un import échoue après l’installation d’un paquet : comparez les chemins de Python et de pip avant de réinstaller. Le paquet peut avoir été ajouté dans un autre environnement.
• Le fichier est introuvable : vérifiez le dossier courant du terminal et le nom exact de expense.py.
• La modification ne change pas le résultat : enregistrez le fichier, puis vérifiez quel fichier la commande d’exécution a lancé.
• Un module standard semble défectueux : évitez de nommer vos propres scripts json.py ou csv.py, car ces noms peuvent masquer les modules correspondants.

D’autres extensions peuvent ajouter leurs propres boutons d’exécution avec des réglages différents. Pour commencer, gardez comme référence les commandes de l’extension Python et le terminal de l’environnement choisi, puis comparez explicitement les autres méthodes si vous les utilisez.