Aller au contenu principal

Installer Python chez soi

Installer Python, un éditeur, et vérifier que tout répond. C'est la première chose à faire quand on suit ce module en cours, parce que les travaux dirigés se font sur la machine et qu'une installation ratée coûte une séance entière.
On peut sauter ce chapitre
Ce parcours s'exécute entièrement dans le navigateur : tous les blocs de code des chapitres suivants tournent sans que rien ne soit installé sur la machine. Si on veut commencer à programmer maintenant, va directement au chapitre Avant de commencer et reviens ici plus tard.
Ce chapitre est numéroté 0 parce qu'il est un préalable pour qui suit le module en présentiel, pas parce qu'il faut l'avoir fini pour apprendre.

Ce qu'on va faire

Compte une vingtaine de minutes, une fois pour toutes.

  • Installer Python et vérifier que la machine le trouve.
  • Installer un éditeur, et les deux extensions qui le rendent utile.
  • Écrire un fichier .py et l'exécuter.
  • Comprendre ce qu'apporte un notebook, et quand il vaut mieux s'en passer.

Installer Python

Sur Windows

  1. Allons sur python.org/downloads et télécharge la dernière version 3.
  2. Ouvrons le fichier téléchargé.
  3. Cocher Add python.exe to PATH avant de cliquer sur Install Now. Cette case est la seule chose importante de tout l'assistant.
  4. Laisser l'installation se terminer.
Si on oublie de cocher la case
Le terminal répondra python : commande introuvable alors que Python est bien installé. La variable PATH est la liste des dossiers où le système va chercher les programmes : sans cette case, Python n'y figure pas.
Le plus simple est de relancer l'installateur, de choisir Modify, et de cocher l'option. Le chapitre Le terminal et le système de fichiers explique ce mécanisme en détail.

Vérifions dans PowerShell :

Terminal1 commande
$python --version
Python 3.12.4

Si la commande n'est pas reconnue, ferme et rouvre le terminal, puis essaie py --version.

Sur macOS

macOS est livré avec une version ancienne de Python, réservée au système. On installe donc la sienne.

  1. Allons sur python.org/downloads et télécharge la version macOS.
  2. Ouvrons le fichier .pkg et suis l'assistant avec les options par défaut.
Terminal1 commande
$python3 --version
Python 3.12.4
python ou python3
Sur macOS et sur la plupart des distributions Linux, python désigne parfois encore Python 2, abandonné depuis 2020, dont la syntaxe diffère. Prenons l'habitude d'écrire python3 et pip3 : on évitera une catégorie entière de messages incompréhensibles.

Sur Linux

Python est presque toujours déjà là. Vérifions avant d'installer quoi que ce soit :

Terminal1 commande
$python3 --version
Python 3.12.3

S'il manque, la distribution le fournit : sudo apt install python3 sur Debian et Ubuntu, sudo dnf install python3 sur Fedora.

Installer Visual Studio Code

Définition

Visual Studio Code est un éditeur de code gratuit. Il colore la syntaxe, complète ce qu'on écrit, signale les erreurs avant l'exécution et lance les programmes, le tout dans une seule fenêtre.

  1. Le télécharger sur code.visualstudio.com et l'installer.
  2. Ouvrons le panneau Extensions avec Ctrl+Shift+X (Cmd+Shift+X sur macOS).
  3. Installer les deux extensions officielles de Microsoft : Python, qui apporte la coloration, la complétion et l'exécution ; Jupyter, qui ouvre les notebooks .ipynb.

Sans la première, VS Code ouvre les fichiers Python comme du texte brut, sans rien en comprendre.

Le parcours Outils de développement consacre un chapitre entier à l'éditeur, à ses raccourcis et au débogage. Y revenir quand on voudra aller plus loin que « ça s'ouvre et ça s'exécute ».

Écrire et exécuter un fichier

Un programme Python est un simple fichier texte dont le nom finit par .py, exécuté de haut en bas, ligne par ligne.

  1. Créer un dossier pour le projet, et ouvre ce dossier dans VS Code (Fichier puis Ouvrir le dossier). Ouvrir le dossier plutôt que le fichier seul change tout : l'éditeur voit alors l'ensemble.
  2. Créer un fichier mon_script.py et écrire dedans :
main.py
Sortie
>_ Prêt à exécuter…
  1. Choisissons l'interpréteur : Ctrl+Shift+P, puis Python: Select Interpreter, puis la version 3 qu'on vient d'installer.
  2. Exécutons avec le bouton ▷ en haut à droite, ou depuis le terminal intégré :
Terminal1 commande
$python3 mon_script.py
Comment tu t'appelles ? Lea
Bonjour Lea, ce programme tourne sur ta machine.
La différence avec la plateforme
Ici, input() attend vraiment qu'on tape au clavier, et le programme peut lire et écrire des fichiers sur le disque. C'est précisément ce que le navigateur interdit, pour de bonnes raisons de sécurité.
Tout le reste est identique : le langage est le même, les programmes des chapitres précédents fonctionneront tels quels.

Les notebooks

Un notebook (.ipynb) découpe le code en cellules exécutables une par une, avec le résultat juste en dessous. C'est le format des chapitres scientifiques de ce parcours, et le principe de cette plateforme.

Il excelle pour explorer des données, tracer une courbe, garder ses essais commentés. Il se prête mal à un programme qu'on veut relancer tel quel : l'ordre d'exécution des cellules n'est pas celui de la lecture, et un notebook réexécuté dans le désordre donne des résultats qu'on ne sait plus reproduire.

La règle est simple : notebook pour chercher, fichier .py pour livrer.

Ça ne marche pas

Les trois pannes de la première installation
« python : commande introuvable » alors que l'installation a réussi : le dossier de Python n'est pas dans le PATH. Sous Windows, relance l'installateur en cochant la case. Fermer et rouvre le terminal, toujours : il lit le PATH à son démarrage.
VS Code n'exécute rien ou souligne du code correct : l'interpréteur sélectionné n'est pas le bon. Ctrl+Shift+P, Python: Select Interpreter.
Un module est introuvable après un pip install : on a installé pour un interpréteur et on exécute avec un autre. Le chapitre Un projet qu'on peut reprendre explique les environnements isolés, qui suppriment cette classe de problèmes.

Vérification

Vérification rapideon peut se reprendre

1.Python est installé, et python --version répond « commande introuvable ». La cause la plus fréquente ?

2.À quoi sert un environnement virtuel ?

3.Un fichier .py et un notebook, quelle différence ?

4.Le terminal affiche SyntaxError avant toute exécution. Que s'est-il passé ?

Synthèse

  • Cocher Add python.exe to PATH sous Windows : c'est la seule case qui compte.
  • Sur macOS et Linux, écrire python3, pas python.
  • Il faut les extensions Python et Jupyter pour que VS Code serve à quelque chose.
  • Ouvrir le dossier du projet, pas le fichier seul.
  • Notebook pour chercher, fichier .py pour livrer.
  • Fermer et rouvre le terminal après toute installation : il ne relit pas le PATH tout seul.