HOWTO · Python

Python unter macOS deinstallieren

Erfahren Sie, wie Sie Python unter macOS für jede Installationsart deinstallieren: eine Homebrew- oder pyenv-Version entfernen, eine python.org-Installation vollständig löschen und die zurückbleibenden Dateien bereinigen.

Auf dieser Seite

Wie Sie Python unter macOS deinstallieren, hängt davon ab, wie es installiert wurde. Der erste Schritt ist daher immer, herauszufinden, welche Installation Sie haben. Dieser Artikel behandelt die drei üblichen Fälle — Homebrew, den python.org-Installer und pyenv — erklärt, warum das mit macOS ausgelieferte Python in Ruhe gelassen werden muss, und endet mit den Dateien, die es sich zu bereinigen lohnt.

Führen Sie zunächst which -a python3 im Terminal aus. Die ausgegebenen Pfade zeigen Ihnen, welche Abschnitte für Sie gelten: Pfade mit /opt/homebrew oder /usr/local/Cellar gehören zu Homebrew, /Library/Frameworks/Python.framework gehört zum python.org-Installer und Pfade unter ~/.pyenv gehören zu pyenv.

Python unter macOS verstehen

Ein Mac kann mehrere Python-Installationen gleichzeitig enthalten, und sie beeinträchtigen sich nicht gegenseitig. Apple liefert einen python3-Befehl mit macOS für seine eigenen Entwicklungswerkzeuge, und alles, was Sie selbst installiert haben — über Homebrew, den python.org-Installer oder pyenv — liegt getrennt daneben.

„Python deinstallieren" bedeutet daher fast immer, eine selbst installierte Kopie zu entfernen, nicht Python als Ganzes. Das Entfernen einer Kopie, von der andere Werkzeuge abhängen, kann diese beschädigen. Identifizieren Sie also die Installation, die Sie tatsächlich entfernen möchten, anhand der Pfade aus which -a python3, bevor Sie etwas löschen.

Mit Homebrew installiertes Python deinstallieren

Wenn Sie Python mit Homebrew installiert haben, lassen Sie Homebrew es entfernen, damit die Dateien und Links der Formel konsistent bereinigt werden. Listen Sie zunächst die von Homebrew installierten Python-Formeln auf:

brew list | grep python

Deinstallieren Sie die Version, die Sie nicht mehr benötigen, und nennen Sie die versionierte Formel:

brew uninstall python@3.12

Ersetzen Sie 3.12 durch die Version aus Ihrer eigenen Liste. Homebrew weigert sich, eine Formel zu deinstallieren, von der andere installierte Formeln abhängen; falls das geschieht, deinstallieren Sie entweder zuerst diese Abhängigkeiten oder wiederholen Sie den Befehl mit --ignore-dependencies, wenn Sie sicher sind, dass nichts sie benötigt.

Überprüfen Sie danach die Entfernung: Die Formel erscheint nicht mehr in brew list | grep python, und which -a python3 gibt keinen Homebrew-Pfad mehr aus. Wenn python3 --version weiterhin antwortet, handelt es sich um eine Ihrer verbleibenden Installationen — meistens die unten beschriebene von macOS.

Von python.org installiertes Python deinstallieren

Der python.org-Installer hat kein eigenes Deinstallationsprogramm. Wie die Python-Dokumentation beschreibt, legt der Installer drei Dinge auf dem Mac ab — einen Ordner Python 3.x in /Applications, das Framework in /Library/Frameworks/Python.framework und Symlinks zu den ausführbaren Dateien in /usr/local/bin — und zum Deinstallieren entfernen Sie diese drei Dinge.

Entfernen Sie immer nur eine Version. Listen Sie zunächst die im Framework vorhandenen Versionen auf:

ls /Library/Frameworks/Python.framework/Versions/

Löschen Sie die Version, die Sie entfernen (hier 3.12), und ihren Applications-Ordner:

sudo rm -rf /Library/Frameworks/Python.framework/Versions/3.12
sudo rm -rf "/Applications/Python 3.12"

Entfernen Sie dann nur die Symlinks, die auf die gelöschte Version zeigen. Listen Sie sie zuerst auf:

ls -l /usr/local/bin | grep "Python.framework/Versions/3.12"

Löschen Sie jeden Link, den der Befehl ausgibt — zum Beispiel sudo rm /usr/local/bin/python3.12 — und lassen Sie Links, die auf andere Versionen oder auf Homebrew zeigen, unberührt. Wenn Sie die letzte Version im Framework entfernt haben, können Sie /Library/Frameworks/Python.framework selbst löschen. Der Installer fügt außerdem das bin-Verzeichnis des Frameworks in ~/.zprofile oder ~/.bash_profile zu Ihrer Shell-PATH hinzu; entfernen Sie auch diese Zeile dort.

Über pyenv installiertes Python deinstallieren

pyenv hält jede installierte Version unter ~/.pyenv/versions, sodass das Entfernen einer Version Ihre anderen Pythons nie berührt. Listen Sie die installierten Versionen auf:

pyenv versions

Deinstallieren Sie die Version, die Sie nicht mehr benötigen:

pyenv uninstall 3.12.4

pyenv fragt um Bestätigung und löscht dann das Verzeichnis dieser Version. Führen Sie pyenv versions erneut aus, um zu bestätigen, dass die Version weg ist; falls es Ihre globale Version war, setzen Sie mit pyenv global eine neue, sonst fällt Ihre Shell auf eine andere Installation zurück.

Das mit macOS ausgelieferte System-Python

macOS selbst stellt einen python3-Befehl in /usr/bin/python3 für die Xcode Command Line Tools und andere Apple-Software bereit. Die Python-Dokumentation ist zu dieser Kopie eindeutig: Sie wird von Apple kontrolliert und von Apple- sowie Drittanbieter-Software verwendet, und Sie sollten sie niemals ändern oder zu löschen versuchen — sie liegt zudem auf dem versiegelten Systemvolume, sodass sie ohnehin nicht auf normalem Weg entfernt werden kann.

In diesem Abschnitt gibt es daher nichts zu deinstallieren. Wenn python3 --version nach dem Entfernen Ihrer eigenen Installationen weiterhin eine Version meldet, prüfen Sie den Pfad mit which python3: Gibt er /usr/bin/python3 aus, ist die verbleibende Kopie die des Systems, und sie an Ort und Stelle zu lassen, ist der korrekte Endzustand.

Restdateien bereinigen

Installer und Paketmanager können kleine Reste zurücklassen. Diejenigen, die es sich zu entfernen lohnt, sind das benutzerspezifische Bibliotheksverzeichnis der deinstallierten Version und der pip-Downloadcache:

rm -rf ~/Library/Python/3.12
rm -rf ~/Library/Caches/pip

Passen Sie die Versionsnummer an die entfernte Version an und löschen Sie nur Verzeichnisse, die zu dieser Version gehören — eine andere Installation mit einer anderen Versionsnummer behält ihr eigenes Verzeichnis und bleibt unberührt. Virtuelle Umgebungen, die Sie mit dem entfernten Python erstellt haben, laufen nicht mehr; löschen Sie auch diese Projektordner oder erstellen Sie sie mit einem verbleibenden Python neu.

Fazit

Python unter macOS zu deinstallieren ist eine Aufgabe pro Installation: Homebrew-Versionen kommen mit brew uninstall heraus, python.org-Installationen durch Entfernen der Framework-Version, des Applications-Ordners und ihrer /usr/local/bin-Symlinks, und pyenv-Versionen mit pyenv uninstall. Das System-Python von macOS ist niemals das Ziel — identifizieren Sie jede Kopie mit which -a python3, entfernen Sie nur die gemeinte und bereinigen Sie nur ihre Reste.

FAQ

  1. Wie prüfe ich, welche Python-Versionen auf macOS installiert sind?
    Führen Sie which -a python3 aus, um jedes python3 in Ihrer PATH zu sehen, und prüfen Sie jeden Manager einzeln mit brew list | grep python und pyenv versions.

  2. Ist es sicher, die Systemversion von Python zu deinstallieren?
    Nein — und es ist auch nicht nötig. Die Kopie in /usr/bin/python3 gehört zu macOS und seinen Entwicklungswerkzeugen; die Python-Dokumentation sagt, dass sie niemals geändert oder gelöscht werden sollte.

  3. Wie kann ich Python nach der Deinstallation wieder installieren?
    Installieren Sie es auf demselben Weg wie zuvor: brew install python für Homebrew, der Installer von python.org oder pyenv install gefolgt von der Versionsnummer für pyenv.

  4. Was soll ich tun, wenn ein Deinstallationsbefehl einen Fehler meldet?
    Lesen Sie, welches Programm ihn ausgegeben hat. Homebrew verweigert, wenn eine andere Formel von dem zu entfernenden Python abhängt; Berechtigungsfehler bei den python.org-Dateien bedeuten, dass der sudo-Schritt übersprungen wurde; ein nicht gefundener Versionsname bedeutet, dass sie von einem anderen Manager installiert wurde.

  5. Kann ich mehrere Python-Versionen gleichzeitig installiert haben?
    Ja. Installationen von Homebrew, python.org und pyenv koexistieren, und pyenv existiert gerade dazu, zwischen mehreren Versionen zu wechseln.