Désinstaller Python sur Mac : python.org, Homebrew, pyenv, Anaconda
Il n'y a pas un Python sur ton Mac, il y en a jusqu'à cinq : python.org, Homebrew, pyenv, Anaconda et celui d'Apple. Chacun se retire autrement, et le dernier ne se supprime jamais. Voici comment trouver le tien, puis le retirer d'après la doc de chaque éditeur, avec ce qu'elle ne dit pas.
Tu veux désinstaller Python de ton Mac, et tu ne sais pas par où commencer. C'est normal : un Mac peut avoir plusieurs Pythons, rangés à des endroits différents, et chacun se retire à sa façon. Il y a celui de python.org, celui de Homebrew, ceux de pyenv, celui d'Anaconda. Et un cinquième que tu n'as pas installé toi-même : le python3 d'Apple, que tu ne dois pas toucher.
Voici comment trouver lequel tu as, puis retirer le bon. On suit la documentation de l'éditeur, et on te dit quand elle reste muette.
Étape 1 : trouve d'où vient ton Python
Ouvre l'app Terminal et tape which python3. La documentation de Python recommande la commande which python3.x pour savoir quel interpréteur répond : remplace le x par ta version, par exemple which python3.15. La réponse est un chemin. Il te dit à quelle famille tu as affaire.
/usr/bin/python3: c'est celui d'Apple. Lis la section suivante, puis laisse-le.- Un lien dans
/usr/local/bin: possible Python de python.org. D'après la doc de Python, l'installeur y place ses liens. Pour confirmer, regarde si un dossier « Python 3.x » existe dans ton dossier Applications. - Un chemin qui contient
.pyenv/shims: pyenv. Son dossier par défaut est~/.pyenv, d'après le README du projet. - Un chemin qui contient
anaconda3ouminiconda3: Anaconda ou Miniconda. On a un article entier là-dessus, plus bas. - Rien de tout ça : peut-être Homebrew. Tape
brew info python: Homebrew indique la version et l'emplacement de ses exécutables.
Plusieurs peuvent cohabiter : la doc de Python l'écrit pour python.org et celui d'Apple. Fais le tour des cas qui te concernent.
Le python3 d'Apple : à laisser tranquille
Les macOS récents incluent une commande python3 dans /usr/bin/python3. D'après la documentation de Python sur macOS, c'est une version souvent plus ancienne et incomplète, fournie par et pour les outils de développement d'Apple : Xcode ou les Command Line Tools. La doc dit de ne jamais la modifier ni tenter de la supprimer. Apple la contrôle, et des logiciels d'Apple comme de tiers s'en servent.
Apple documente bien la suppression des Command Line Tools, dans Installing the command-line tools. Mais ça retire tout le paquet, avec le compilateur et les outils de développement, pas seulement Python. Ce n'est pas ce que tu cherches ici.
Python de python.org : retire trois éléments
C'est le cas le plus courant quand tu as téléchargé un fichier .pkg sur le site de Python. L'installeur de python.org écrit dans trois emplacements fixes, et la doc dit que, pour désinstaller Python, tu peux retirer ces éléments :
- le dossier Python 3.x dans Applications ;
- le framework Python.framework dans
/Library/Frameworks; - les liens vers l'exécutable placés dans
/usr/local/bin.
On les prend dans l'ordre. La marche est celle d'Apple pour supprimer une app.
Le dossier Applications.
- Quitte IDLE et Python Launcher s'ils sont ouverts.
- Ouvre le Finder, puis Applications. Repère le dossier « Python 3.x », avec ta version à la place du x. Il contient IDLE, Python Launcher et le Read Me de l'installation.
- Glisse ce dossier dans la Corbeille. Si le Mac demande un mot de passe, donne celui d'un compte administrateur.
Le framework.
- Dans le Finder, ouvre le menu Aller, puis Aller au dossier (ou Maj + Commande + G, d'après la liste des raccourcis d'Apple).
- Tape
/Library/Frameworkset valide. - Glisse Python.framework dans la Corbeille. Depuis Python 3.15, l'installeur met aussi par défaut une variante sans verrou GIL, dans un dossier voisin nommé PythonT.framework : il part de la même façon.
Les liens dans /usr/local/bin. Ouvre ce dossier avec Aller au dossier. Repère les liens python3.x de ta version. La doc cite en exemple python3.15, python3.15t et python3.15t-config, mais elle ne donne pas la liste complète. Mets à la Corbeille ceux qui portent le nom de ta version et rien d'autre : la doc précise qu'une autre distribution peut ranger ses propres liens à cet endroit.
Pour finir. Choisis Finder > Vider la corbeille. Dernier détail : la doc dit que l'installeur ajoute le framework au chemin de ton shell, sans préciser dans quel fichier. On ne peut donc pas t'indiquer où retirer cette ligne.
Plusieurs versions installées ? La doc n'explique pas comment en retirer une seule. Elle cite seulement des chemins du type /Library/Frameworks/Python.framework/Versions/3.15/bin/python3.15. On ne te donne donc pas de marche non vérifiée : refais les trois étapes pour chaque version à retirer, en relisant le nom de chaque dossier.
Les environnements virtuels de tes projets, les dossiers .venv créés avec python3 -m venv, ne font pas partie de ces trois éléments. Ils restent où ils sont.
Python de Homebrew : brew uninstall
Si tu as installé Python avec Homebrew, le Finder ne sert à rien. Tout passe par brew. Voici la marche, d'après la documentation de Homebrew et son manuel.
- Vérifie que rien n'en dépend :
brew uses --installed python. La commande liste les formules installées qui ont besoin de Python. - Si la liste est vide, retire-le :
brew uninstall python. Pour voir ce qui partirait sans rien toucher, ajoute--dry-run. - Passe ensuite
brew autoremove. Il retire les formules installées seulement comme dépendance et devenues inutiles. Là aussi,--dry-runmontre la liste avant.
Brew refuse parce que d'autres formules s'en servent ? C'est voulu : Homebrew explique qu'une formule qui déclare Python comme dépendance doit le garder, sinon ses scripts et ses modules ne marchent plus. --ignore-dependencies force la désinstallation malgré tout. À toi de décider si tu casses l'outil qui en dépend.
Dernier point : Homebrew ne gère pas les paquets posés directement avec pip. Ils ne figurent pas dans ses registres, et brew ne les retire pas. Pour la place que Homebrew garde encore après, voir notre guide pour nettoyer Homebrew.
Une version plus ancienne installée à côté ? La doc de Homebrew parle de formules versionnées, mais ne donne pas leur nom. brew info te le dit, et la commande de retrait est la même avec ce nom.
Python de pyenv : pyenv uninstall
pyenv installe chaque version dans son propre dossier, sous $(pyenv root)/versions. Le README du projet donne deux gestes.
Retirer une version.
- Liste-les avec
pyenv versions. Un astérisque marque celle qui est active. - Retire-en une :
pyenv uninstall 3.10.4, avec ta version à la place. L'option-févite la demande de confirmation.
Retirer pyenv en entier. Le README procède en deux temps.
- Retire toutes les lignes de configuration de pyenv dans le fichier de démarrage de ton shell, par exemple
~/.zshrcpour Zsh. Sans ça,pythonfonctionne à nouveau comme avant pyenv, avec le Python « system ». - Supprime son dossier :
rm -rf $(pyenv root). Attention, cette commande efface tout de suite toutes les versions installées par pyenv, sans passer par la Corbeille. Si tu avais installé pyenv avec Homebrew, termine parbrew uninstall pyenv.
Python d'Anaconda : un autre article
Anaconda et Miniconda embarquent leur propre Python dans un dossier à eux, avec leurs environnements. Leur retrait passe par un script officiel, pas par la Corbeille. Tout est dans notre guide pour désinstaller Anaconda sur Mac.
Vérifie que c'est terminé
Rouvre le Terminal et relance which python3.x avec ta version. Tu ne dois plus voir le chemin que tu viens de retirer. S'il apparaît encore, ferme la fenêtre et ouvre-en une nouvelle.
Un python3 répond toujours, et c'est normal : c'est celui d'Apple, dans /usr/bin/python3.
Si ça bloque
Le Mac dit que l'élément est « en cours d'utilisation ». Vérifie qu'IDLE, Python Launcher ou un script Python ne tourne plus. Apple conseille sinon de redémarrer, ou de passer par le mode sans échec, puis de réessayer.
La Corbeille ne se vide pas. Notre article Corbeille impossible à vider prend le relais.
Un outil ne marche plus après la désinstallation. Il utilisait sans doute ce Python. Réinstalle-le, ou installe le Python qu'il demande dans un environnement virtuel de son projet. Homebrew le recommande d'ailleurs, pour ne pas toucher à l'installation de base.
Ce que CleanMochi fait, et ne fait pas, avec Python
CleanMochi est l'app que nous faisons pour les Mac. On a relu son code avant d'écrire ces lignes. Il n'a aucune règle propre à Python, et on ne l'a pas testé sur un Python de python.org. Voici ce qu'il fait pour toutes les apps.
Ce qu'il ne fait pas.
- Il ne touche ni à
/Library/Frameworks, ni à/usr/local/bin, ni à/usr/bin. Le framework Python, ses liens et le python3 d'Apple sont donc hors de son périmètre. - Il ne retire pas le dossier « Python 3.x » d'un seul geste : son écran Applications ne liste que des apps, et un dossier n'en est pas une.
- Il ne lance aucune commande de désinstallation de Homebrew ni de pyenv, et ne gère pas Anaconda. Il ne modifie pas non plus les fichiers de démarrage de ton shell.
Ce qu'il fait.
- Applications : la liste montre les apps de
/Applications, de ton dossier Applications personnel, et d'un niveau de sous-dossier. IDLE et Python Launcher, rangés dans le dossier « Python 3.x », peuvent donc y figurer. Déplie la ligne, puis clique sur Désinstaller…. L'app est fermée, puis mise à la Corbeille avec les restes cochés trouvés dans ta Bibliothèque personnelle, dans douze dossiers dont Application Support et Caches. Si l'app refuse de se fermer, rien ne bouge. - Annuler : juste après, ce bouton remet l'app et ses restes à leur place, tant que la Corbeille n'est pas vidée.
- Nettoyage > Caches de développement : ce groupe, décoché d'office, propose entre autres le cache de pip et celui de Homebrew. Ce sont des copies qui se retéléchargent. Attention : ce groupe supprime directement, sans passer par la Corbeille.
- Nettoyage > Restes d'apps désinstallées : cette liste, décochée elle aussi, n'inclut jamais les réglages dont le nom commence par
org.python. CleanMochi les considère comme appartenant à des outils partagés, pas à une app précise.
CleanMochi se télécharge sur cleanmochi.com.
À lire aussi
- Désinstaller Anaconda sur Mac : retirer conda sans rien oublierGlisser Anaconda-Navigator à la Corbeille ne retire presque rien : Python, conda et tes environnements restent sur le disque. Voici la méthode donnée par Anaconda, du script uninstall.sh au nettoyage manuel, pour Anaconda Distribution comme pour Miniconda.
- brew cleanup : nettoyer Homebrew sur Mac, cache et vieilles versionsHomebrew garde ses téléchargements et tes anciennes versions bien plus longtemps que tu ne le crois. Voici ce que fait vraiment brew cleanup, les options qui vident le cache en entier, autoremove pour les dépendances orphelines, et comment retirer Homebrew pour de bon.
- Désinstaller complètement une application Mac, sans laisser de tracesGlisser une app à la Corbeille ne suffit pas. Où restent ses fichiers, comment tout retirer à la main, quand utiliser le désinstalleur de l'éditeur, et ce qu'il ne faut pas toucher.
- CleanMochi, l'app qui garde ton Mac rapideCe que fait l'app, avec ses écrans principaux et une courte vidéo.
Questions fréquentes
Comment désinstaller Python sur Mac ?
Cela dépend d'où il vient. Pour Python de python.org, la doc de Python dit de retirer le dossier Python 3.x d'Applications, Python.framework dans /Library/Frameworks et les liens de /usr/local/bin. Pour Homebrew, tu utilises brew uninstall python. Pour pyenv, pyenv uninstall suivi de la version. Commence par which python3 pour savoir lequel tu as.
Peut-on supprimer le python3 d'Apple, dans /usr/bin ?
Non. D'après la documentation de Python, c'est une installation contrôlée par Apple, fournie pour les outils de développement Xcode et Command Line Tools, que tu ne dois jamais modifier ni tenter de supprimer. Des logiciels d'Apple et de tiers s'en servent.
Désinstaller Python casse-t-il mon Mac ?
Retirer un Python de python.org, de Homebrew ou de pyenv ne touche pas à celui d'Apple, que la doc dit de laisser. Un outil qui utilisait le Python que tu retires peut en revanche cesser de marcher. Pour Homebrew, brew refuse de retirer un Python dont une autre formule dépend, sauf si tu ajoutes --ignore-dependencies.
Comment savoir quelle version de Python j'ai ?
Dans le Terminal, la commande which python3.x, avec ta version à la place du x, te donne le chemin du Python qui répond, d'après la doc de Python. Le chemin dit d'où il vient : /usr/bin pour Apple, /usr/local/bin pour un lien de python.org, .pyenv pour pyenv. brew info python donne l'emplacement du Python de Homebrew.
Les paquets installés avec pip partent-ils avec Python ?
Cela dépend. Homebrew écrit qu'il ne gère pas les paquets posés directement par pip : brew ne les retire pas. Les environnements virtuels de tes projets restent aussi dans leur dossier. Chez python.org, la doc ne détaille pas ce qui est retiré en dehors des trois éléments cités plus haut.
Article rédigé par l'équipe de CleanMochi (AppsMochi, une marque de NORY LLC). Une erreur, un chemin qui a changé avec une nouvelle version de macOS ? Dis-le nous.