Configurer un environnement de développement Python sur Mac : de l’installation à l’exécution pour débutants en 2026

La commande Python semble introuvable, ou le terminal lance une version différente de celle du cours.

Cette semaine, commencez par vérifier la version demandée par votre cours, puis choisissez l’installateur officiel ou Homebrew et créez un environnement séparé pour chaque projet.

Ce guide s’adresse aux étudiants qui découvrent Python sur Mac et veulent installer puis exécuter leur premier programme.
Il aide aussi les débutants déjà équipés de Python à éviter les mélanges entre projets.
Si votre cours demande macOS et que vous n’avez pas de Mac, vous pourrez vérifier si un accès à distance convient à vos exercices.

Avant l’installation : les consignes du cours

Ne commencez pas par installer la version la plus récente disponible. Une consigne de cours, un projet déjà fourni ou un fichier de dépendances peut demander une version précise de Python. Si votre installation ne correspond pas, certains outils du cours peuvent réagir différemment, même si votre code paraît correct.

Repérez d’abord les éléments utiles dans la plateforme de cours, le dépôt du projet ou le sujet du devoir :

la version de Python attendue, si elle est indiquée ;
l’éditeur recommandé, sans confondre éditeur de texte et interpréteur Python ;
la présence d’un fichier requirements.txt, qui peut énumérer les bibliothèques nécessaires ;
les consignes pour lancer le programme et les éventuels accès à des fichiers ou à une interface graphique.

Un éditeur est l’endroit où vous écrivez le code ; l’interpréteur est le programme qui lit et exécute ce code. Ils peuvent être installés ensemble ou séparément. Cette distinction explique un problème courant : un éditeur affiche une version de Python, tandis que le terminal en utilise une autre.

Comment installer la version demandée par le cours ?

Vérifiez d’abord si les consignes précisent une version ou une plage de versions. Consultez ensuite les options proposées par la page officielle des téléchargements Python pour macOS, puis les informations propres à votre Mac dans le guide officiel d’utilisation de Python sur Mac. Ne déduisez pas qu’une version conviendra simplement parce qu’elle est la plus récente : l’installation et la compatibilité dépendent des consignes du projet et des options officiellement disponibles au moment où vous le faites.

Le Python déjà présent sur un ordinateur et celui que vous installez peuvent aussi être distincts. Il faut donc vérifier quel interpréteur répond à une commande dans le terminal, au lieu de supposer que toutes les applications utilisent automatiquement la même installation. La documentation du langage sur l’interpréteur interactif explique comment le lancer et exécuter des instructions.

Choix de l’installation : installateur officiel ou Homebrew

Les deux voies sont valables pour apprendre ; le meilleur choix dépend surtout des consignes du cours et de votre façon de gérer les outils.

L’installateur officiel convient si vous souhaitez suivre directement la méthode proposée par Python. Homebrew peut être pratique si vous l’utilisez déjà pour gérer d’autres outils depuis le terminal. En revanche, si vous débutez, ajouter Homebrew uniquement pour installer Python implique de suivre aussi ses propres étapes d’installation et de comprendre où les commandes installées sont accessibles. Sa documentation décrit les conditions et la procédure d’installation de Homebrew, ainsi que la gestion des langages et environnements d’exécution.

Le choix rapide : si votre enseignant donne une procédure précise, suivez-la. Sinon, choisissez une seule méthode, installez Python avec celle-ci, puis contrôlez le résultat dans le terminal avant d’en ajouter une autre. Installer plusieurs fois Python « pour être sûr » peut compliquer le diagnostic : le terminal risque de trouver une installation différente de celle utilisée par l’éditeur.

Après l’installation, ouvrez une nouvelle fenêtre de terminal et vérifiez ce qu’elle trouve :

python3 --version

La commande demande à l’interpréteur de communiquer sa version. Comparez le résultat à la consigne du cours : un résultat différent ne prouve pas forcément que l’installation a échoué, mais indique qu’il faut vérifier l’interpréteur appelé. Le guide officiel de Python sur Mac et le tutoriel consacré à l’interpréteur permettent de replacer ce contrôle dans le fonctionnement propre à macOS.

Faut-il installer Python avec Homebrew ou depuis le site officiel ?

Situation	Choix à privilégier	Vérification après installation
Le cours fournit une méthode d’installation	La méthode prescrite par le cours	La version renvoyée dans le terminal
Vous voulez suivre la procédure de Python	L’installateur officiel pour macOS	Que l’installation répond à la commande attendue
Vous gérez déjà des outils avec Homebrew	Homebrew, en suivant sa documentation	Que le terminal trouve bien le Python installé
Vous ne savez pas quelle méthode choisir	Une seule méthode au départ, sans installation en doublon	Le résultat de `python3 --version`

Ce tableau sert à choisir une voie, pas à garantir que toutes les consignes de cours seront satisfaites par défaut. En cas de divergence, la consigne du projet reste prioritaire.

Première exécution : terminal et script de test

Une fois la commande disponible, commencez par une instruction courte plutôt que par un projet complet. Le mode interactif permet de saisir directement du code dans le terminal :

python3

À l’invite de Python, saisissez :

print("Bonjour, Python !")

L’interpréteur doit afficher le texte demandé. Pour quitter le mode interactif, utilisez exit() ou la combinaison prévue par votre terminal. La documentation Python explique ce mode de lancement ; il est utile pour essayer une instruction, mais ne remplace pas un fichier de programme que vous pourrez enregistrer et reprendre.

Pour tester un script enregistré, créez un fichier nommé bonjour.py dans un dossier de travail et écrivez-y :

print("Bonjour depuis un fichier !")

Enregistrez le fichier, puis placez le terminal dans le dossier qui le contient. Lancez-le avec :

python3 bonjour.py

Si le texte s’affiche, le terminal a trouvé un interpréteur et a exécuté le fichier. Si la commande échoue, gardez le message complet : il donne souvent une indication plus utile que la seule mention « ça ne marche pas ».

Que vérifier si le terminal ne trouve pas Python ?

Commencez par fermer puis rouvrir le terminal, puis réessayez la commande de vérification. Si la commande reste introuvable ou renvoie une version inattendue, évitez de relancer plusieurs installations à l’aveugle. Vérifiez plutôt quelle méthode a été utilisée, suivez sa documentation et regardez si l’éditeur pointe vers le même interpréteur.

Un autre piège fréquent se situe dans le dossier courant. Si le terminal ne trouve pas bonjour.py, le problème peut être son emplacement plutôt que Python lui-même. Vérifiez que le nom du fichier et le dossier affiché par le terminal correspondent à ceux que vous avez enregistrés. Un fichier créé dans un éditeur peut aussi porter une extension différente de celle attendue ; contrôler son nom complet permet de distinguer cette erreur d’un problème d’installation.

Environnement de projet : une boîte à outils par devoir

Un environnement virtuel est un espace associé à un projet, avec son propre ensemble de bibliothèques. Imaginez une boîte à outils dédiée à chaque devoir : une bibliothèque nécessaire à un exercice n’est pas ajoutée automatiquement aux autres projets. Cette séparation réduit les conflits lorsque deux exercices s’appuient sur des dépendances différentes.

Depuis le dossier du projet, créez l’environnement :

python3 -m venv .venv

La commande utilise le module intégré venv pour créer un environnement dans le dossier .venv. La documentation officielle de venv décrit son rôle et son utilisation.

Activez-le dans le terminal :

source .venv/bin/activate

L’invite du terminal peut alors afficher le nom de l’environnement, ce qui aide à repérer dans quel contexte vous travaillez. Cette activation concerne le terminal courant : si vous ouvrez une nouvelle fenêtre, vérifiez à nouveau l’environnement avant d’installer des bibliothèques ou d’exécuter le projet. Dans un éditeur, sélectionnez également l’interpréteur associé au dossier .venv si l’application vous le demande. C’est une source de confusion classique : le terminal peut utiliser l’environnement du projet alors que l’éditeur continue d’en utiliser un autre.

Si le cours fournit un fichier requirements.txt, installez les dépendances depuis cet environnement activé :

python3 -m pip install -r requirements.txt

Le format de ce fichier et la commande d’installation sont décrits dans le guide officiel de Python Packaging sur pip et les environnements virtuels et dans la documentation de référence de pip sur les fichiers de dépendances. N’installez pas toutes les bibliothèques rencontrées dans un tutoriel au niveau général du système : vérifiez d’abord si elles sont nécessaires au projet et si l’environnement est activé.

Pour quitter l’environnement du projet dans le terminal, tapez :

deactivate

Comment séparer plusieurs projets Python ?

Créez un dossier et un environnement .venv pour chaque projet, puis installez les dépendances dans le contexte correspondant. Cette habitude est particulièrement utile pour les exercices créatifs : un projet de traitement audio peut dépendre de bibliothèques différentes d’un script de montage vidéo, d’analyse d’images ou d’une petite application de conception. Ne partez pas du principe que leurs outils peuvent être échangés sans vérifier les consignes.

Avant chaque séance, contrôlez que vous vous trouvez dans le bon dossier et que l’environnement du projet est activé. Si un paquet semble manquer alors qu’il a déjà été installé, vérifiez d’abord ces deux points. Réinstaller la bibliothèque ailleurs peut masquer le problème pour un moment, sans corriger le fait que le projet et le terminal n’utilisent pas le même environnement.

Progression : contrôle avant de poursuivre

Avant de passer à un devoir plus important, cochez les actions qui correspondent à votre situation :

[ ] J’ai relevé la version de Python demandée par le cours, ou confirmé qu’aucune version précise n’est indiquée.
[ ] J’ai choisi une seule méthode d’installation et vérifié la version que le terminal trouve.
[ ] J’ai exécuté une instruction courte dans l’interpréteur ou lancé un fichier .py.
[ ] J’ai créé un environnement virtuel dans le dossier du projet et vérifié qu’il est activé.
[ ] J’ai installé uniquement les dépendances prévues par le cours ou le projet.
[ ] J’ai confirmé que mon éditeur utilise le même environnement que le terminal.

Moment du travail	Commande ou contrôle	Ce que le résultat permet de vérifier
Après l’installation	`python3 --version`	Quel interpréteur répond dans le terminal
Premier essai interactif	`python3` puis `print(...)`	Que Python accepte et exécute une instruction
Essai d’un fichier	`python3 bonjour.py`	Que le script est accessible depuis le dossier courant
Préparation du projet	`python3 -m venv .venv`	Que le dossier du projet dispose d’un environnement séparé
Installation des dépendances	`python3 -m pip install -r requirements.txt`	Que les dépendances du fichier sont installées dans le contexte actif

Entretien : mises à jour et erreurs récurrentes

Un projet peut fonctionner aujourd’hui et échouer après un changement de version ou de dépendances. Avant de mettre à jour Python ou les bibliothèques d’un devoir, relisez les consignes et vérifiez ce que le projet attend. Une mise à jour n’est pas automatiquement bénéfique si elle rend l’installation différente de celle utilisée pendant le cours.

Pour rendre votre travail plus facile à reprendre, conservez les consignes utiles avec le projet : version attendue, procédure de lancement et fichier de dépendances fourni. Lorsque le cours ne fournit pas de fichier, n’en créez pas un en recopiant des bibliothèques au hasard ; notez d’abord ce que le projet utilise et vérifiez la procédure demandée.

En cas d’erreur, relevez le message complet, la commande lancée, le dossier courant et l’état de l’environnement virtuel. Vérifiez ensuite si le terminal et l’éditeur utilisent le même interpréteur. Ces informations permettent de distinguer une dépendance absente d’un mauvais dossier ou d’une installation différente, sans recommencer toute la configuration.

Situation d’apprentissage	Environnement souvent adapté	Limite à vérifier
Exercices Python simples, sans exigence particulière de macOS	Mac ou autre ordinateur compatible avec les outils du cours	Les consignes et les dépendances restent déterminantes
Projet dont les instructions exigent macOS ou un outil réservé à macOS	Un environnement macOS, local ou distant selon les besoins	Vérifier les fichiers, l’interface et les accès matériels nécessaires
Ordinateur d’école verrouillé ou installation interdite	Une solution autorisée par l’établissement, éventuellement à distance	Le transfert de fichiers et l’accès à l’interface peuvent être contraignants
Travail régulier sur une machine personnelle	Installation locale correspondant au cours	L’entretien, les mises à jour et la séparation des projets vous reviennent

Exercices sans Mac : limites et choix de l’environnement

Pour apprendre les bases de Python, un Mac n’est pas une obligation en soi : le cours peut fonctionner sur différents systèmes. La situation change si les consignes imposent macOS, si un outil du projet n’existe que sur cette plateforme ou si l’ordinateur de l’établissement interdit les installations.

Un environnement distant peut alors servir de poste de pratique, mais il ne répond pas à tous les besoins. Avant de le choisir, vérifiez si le cours exige des fichiers locaux, une interface graphique, un accès à un périphérique particulier ou une connexion que l’établissement autorise. L’accès à distance implique aussi de prendre en compte le réseau et les transferts de fichiers ; pour un exercice Python entièrement textuel, cette contrainte peut être superflue.

Les pages de présentation des offres PingMini et de partage d’écran PingMini permettent de consulter les informations disponibles sur les modalités d’accès, avant de décider si cette option correspond à votre cours. Elles ne remplacent pas la vérification des exigences du devoir.

Option	Atout pour l’apprentissage	Coût pratique à prendre en compte
Mac personnel	Accès direct aux fichiers et au terminal de la machine	Achat et entretien de l’ordinateur
Ordinateur fourni par l’établissement	Pas besoin d’installer les outils sur son propre appareil si tout est déjà disponible	Restrictions d’installation et disponibilité de la machine
Environnement distant sur Mac	Accès possible à un environnement macOS sans achat immédiat d’un Mac personnel	Dépendance au réseau, aux transferts et aux conditions d’accès
Ordinateur déjà disponible pour Python	Suffisant pour de nombreux exercices généralistes	Ne convient pas si le cours exige explicitement macOS

Pour des exercices ordinaires, changer d’ordinateur uniquement pour apprendre la syntaxe Python n’est généralement pas nécessaire. En revanche, un ordinateur d’école verrouillé peut empêcher l’installation, et un environnement distant dépend de la connexion et peut rendre la gestion des fichiers moins directe. Si le cours impose macOS et que ces contraintes bloquent réellement les exercices, louer un Mac via PingMini peut offrir un environnement de pratique sans achat d’appareil ; il reste utile de comparer cette option avec l’accès à un Mac personnel ou fourni par l’établissement. Choisissez selon les exigences du cours : installez Python localement lorsque cela suffit, et consultez les modalités d’accès à distance lorsque macOS est indispensable et que votre matériel actuel ne le permet pas.