HOWTO · Python

Miniconda vollständig deinstallieren

Miniconda unter Windows, macOS oder Linux sicher deinstallieren und optionale Reste nur bei Bedarf entfernen.

Auf dieser Seite

Um Miniconda sicher zu deinstallieren, exportieren Sie zuerst jede Umgebung, die Sie behalten möchten, ermitteln den genauen Installationspräfix und verwenden dann das Deinstallationsprogramm Ihres Betriebssystems. Entfernen Sie Shell-Einstellungen und conda-Benutzerdaten nur, wenn Sie bewusst einen vollständigen Neustart wünschen: Diese optionalen Schritte können Einstellungen und zwischengespeicherte Pakete löschen.

Umgebungen sichern und den Installationspräfix ermitteln

Beim Deinstallieren einer Miniconda-Installation werden die Umgebungen und Pakete innerhalb dieses Installationsverzeichnisses entfernt. Exportieren Sie vor dem Fortfahren eine Umgebung, die Sie später wiederherstellen möchten. Führen Sie beispielsweise conda env export --name myenv > myenv.yml aus und bewahren Sie myenv.yml außerhalb des Miniconda-Verzeichnisses auf. Nach einer Neuinstallation von conda können Sie sie mit conda env create --file myenv.yml wieder erstellen.

Löschen Sie ein Verzeichnis nicht allein deshalb, weil sein Name wie Miniconda aussieht. Fragen Sie unter macOS und Linux zuerst conda nach dem Basispräfix. Der folgende Vorabtest gibt das Verzeichnis aus, wenn conda verfügbar ist, und beendet sich vor dem Löschen, wenn es nicht verfügbar ist:

if ! prefix="$(conda info --base 2>/dev/null)"; then
  printf '%s\n' 'conda is not on PATH; find the installation prefix before deleting anything.'
  exit 1
fi
printf 'Miniconda prefix: %s\n' "$prefix"

Bei einer funktionierenden Installation hat die letzte Zeile diese Form:

Miniconda prefix: /opt/miniconda3

Wenn der Vorabtest meldet, dass conda nicht im PATH ist, setzen Sie keinen geratenen Pfad in einen Löschbefehl ein. Suchen Sie zuerst das Verzeichnis des ursprünglichen Installers oder verwenden Sie das mit dieser Installation gelieferte Deinstallationsprogramm. Dieser Grenzfall ist absichtlich vorsichtig: Das Löschen des falschen Präfixes kann eine andere conda-Installation entfernen.

Miniconda unter Windows deinstallieren

Verwenden Sie das Windows-Deinstallationsprogramm, das mit der Miniconda-Installation geliefert wurde. Öffnen Sie Einstellungen > Apps > Installierte Apps (oder bei älteren Windows-Versionen Apps & Features), wählen Sie Miniconda und dann Deinstallieren. Der Leitfaden zur Deinstallation von Anaconda Miniconda beschreibt das aktuell unterstützte Verfahren.

Schließen Sie vor dem Start Eingabeaufforderung, PowerShell, IDE-Terminals und Python-Prozesse, die diese Installation verwenden. Öffnen Sie nach Abschluss des Deinstallationsprogramms ein neues Terminal und führen Sie where conda aus. Wenn dies Ihre einzige conda-Installation war, ist eine Meldung ohne passendes Programm das erwartete Ergebnis. Wird weiterhin ein Pfad gefunden, prüfen Sie ihn: Er kann zu einer separaten Anaconda-, Miniconda- oder Miniforge-Installation gehören, die Sie nicht versehentlich entfernen sollten.

Miniconda unter macOS oder Linux deinstallieren

Führen Sie bei einem Installer, der ihn bereitstellt, das Skript uninstall.sh aus dem exakt ermittelten Miniconda-Präfix aus. Folgen Sie den Anweisungen dieses Skripts, statt einen allgemeinen rm -rf-Befehl zu kopieren. Der offizielle Deinstallationsleitfaden trennt diese unterstützte Entfernung von der optionalen Bereinigung, weil Deinstallationsprogramme Konfigurationen auf Benutzerebene zurücklassen können.

Falls kein Deinstallationsprogramm verfügbar ist, ist manuelles Löschen nur eine Ausweichlösung, nicht die erste Wahl. Prüfen Sie den Präfix erneut, stellen Sie sicher, dass es die gewünschte Miniconda-Installation ist, und entfernen Sie dann nur dieses Verzeichnis. Die conda-Dokumentation beschreibt den manuellen Weg und die optionalen Bereinigungsschritte für macOS. rm -rf fragt nicht nach einer Bestätigung und kann nicht rückgängig gemacht werden; verwenden Sie es nie mit einem leeren, ungeprüften oder zu breiten Pfad wie Ihrem Home-Verzeichnis.

Öffnen Sie nach dem Entfernen eine neue Shell und führen Sie command -v conda aus. Keine Ausgabe bedeutet, dass der Befehl im aktuellen PATH nicht mehr gefunden wird. Gibt der Befehl einen Pfad aus, ist entweder eine andere conda-Installation vorhanden oder Ihre Shell enthält noch einen Initialisierungseintrag.

Optionale Shell- und Benutzerdatenreste entfernen

Für die eigentliche Deinstallation müssen nicht alle conda-bezogenen Dateien gelöscht werden. Wählen Sie diese Schritte nur, wenn Sie conda für das Benutzerkonto zurücksetzen möchten:

  • Machen Sie die Shell-Initialisierung mit conda init --reverse --all rückgängig, bevor Sie die Installation entfernen, solange conda noch verfügbar ist. Alternativ entfernen Sie nach Prüfung nur den conda-Initialisierungsblock aus der passenden Shell-Startdatei.
  • Erwägen Sie das Entfernen von .condarc, .conda und .continuum nur, wenn Sie deren Einstellungen, zwischengespeicherte Pakete oder andere Benutzerdaten nicht benötigen. Bewahren Sie bei Unsicherheit zuerst eine Kopie auf.
  • Prüfen Sie Shell-Dateien wie .bashrc, .zshrc oder das PowerShell-Profil auf veraltete Miniconda-Pfade. Entfernen Sie nur die Zeilen zur entfernten Installation und starten Sie dann ein neues Terminal.

Verwenden Sie anaconda-clean nicht als primäres Miniconda-Deinstallationsprogramm. Es ist ein Bereinigungswerkzeug, während das unterstützte Deinstallationsprogramm oder ein sorgfältig geprüfter manueller Ausweichweg die Installation selbst entfernt. Eine optionale Bereinigung ist bei einer Neuinstallation sinnvoll, aber nicht erforderlich, um nur das Miniconda-Verzeichnis freizugeben.

Ergebnis prüfen und bei Bedarf neu installieren

Die Prüfung sollte zeigen, dass der entfernte Präfix nicht mehr existiert und ein neues Terminal conda oder die alte Python-Datei aus diesem Präfix nicht mehr auflöst. Verwenden Sie unter Windows where conda, unter macOS oder Linux command -v conda. Wenn ein Befehl weiterhin aufgelöst wird, vergleichen Sie den gemeldeten Ort mit dem entfernten Präfix, bevor Sie PATH ändern oder etwas anderes löschen.

Sie können Miniconda später neu installieren, ohne alte Konfigurationsdateien wiederherzustellen. Erstellen Sie bei Bedarf eine neue Umgebung aus der gesicherten YAML-Datei. Scheitert die Entfernung, weil eine Datei verwendet wird oder eine Berechtigung fehlt, schließen Sie Programme, die diese Installation verwenden, und führen Sie das unterstützte Deinstallationsprogramm mit den passenden Kontoberechtigungen erneut aus; löschen Sie keinen ungeprüften Pfad mit Gewalt.