pip meldet Erfolg, aber der Import scheitert? Oft landet das Paket in einer anderen Umgebung, als das Skript nutzt — das venv war nicht aktiv.
Aufwand:
ca. 20 Min.
Das Symptom
Ein Python-Skript bricht mit ModuleNotFoundError ab und behauptet, ein Paket sei
nicht installiert — obwohl man es gerade eben mit pip installiert hat und pip den
Erfolg gemeldet hat. Auf einem anderen Rechner oder in einer anderen Konsole
funktioniert dasselbe Skript.
Die „Layer 8“-Wahrheit
Auf einem Rechner leben oft mehrere Python-Welten nebeneinander: das System-Python,
vielleicht eine zweite Installation und für jedes Projekt eine eigene abgeschottete
virtuelle Umgebung. Jede dieser Welten hat ihren eigenen Satz installierter Pakete.
Der Fehler entsteht, wenn Installation und Ausführung in verschiedene Welten fallen:
pip legt das Paket brav ab — nur eben in einer anderen Umgebung, als das Skript
später benutzt. Beide Seiten haben recht, sie reden nur aneinander vorbei.
Der Schlüssel ist deshalb nicht, das Paket noch einmal zu installieren, sondern
sicherzustellen, dass pip und der ausführende Interpreter auf dieselbe Umgebung
zeigen. Ein Blick darauf, welches Python und welches pip gerade aktiv sind, deckt das
Auseinanderdriften sofort auf. Wer die virtuelle Umgebung vor dem Arbeiten aktiviert
und pip als Modul genau des gewünschten Interpreters aufruft, trifft garantiert die
richtige Welt — und der Import gelingt.
Die echte, verifizierte Lösung
1000 % faktenbasiert. Jeder Befehl ist real, jeder Pfad existiert. Schritt für Schritt:
1.
Das Auseinanderdriften erkennen
Ein Paket lässt sich mit pip scheinbar erfolgreich installieren, aber das Skript findet es nicht. Fast immer wurde es in eine andere Python-Umgebung installiert, als das Skript verwendet — etwa ins System-Python, während das Projekt in einer virtuellen Umgebung läuft, oder umgekehrt.
2.
Prüfen, welches Python und pip aktiv sind
Nachsehen, auf welche ausführbaren Dateien Python und pip gerade zeigen. Liegen sie in verschiedenen Verzeichnissen, passt der Installationsort nicht zum Ausführungsort:
which python
which pip
3.
Die virtuelle Umgebung aktivieren
Ist eine virtuelle Umgebung angelegt, muss sie in der aktuellen Shell aktiviert sein, bevor man installiert oder startet. Am Prompt sollte danach der Name der Umgebung in Klammern erscheinen:
source .venv/bin/activate
4.
Paket und Skript in derselben Umgebung halten
Die goldene Regel: In genau der Umgebung installieren, in der das Skript läuft. Um Verwechslungen ganz auszuschließen, pip als Modul des gewünschten Interpreters aufrufen — so trifft die Installation garantiert das richtige Python:
python -m pip install paketname
5.
Die Umgebung neu anlegen, wenn nötig
Ist eine virtuelle Umgebung beschädigt oder auf einen nicht mehr existierenden Interpreter verweisend, sie löschen und neu anlegen. Danach die Abhängigkeiten frisch aus der Anforderungsdatei installieren.
Häufige Fragen (FAQ)
?Ich habe das Paket installiert, Python findet es trotzdem nicht. Wie kann das sein?
Weil Installation und Ausführung in verschiedenen Umgebungen stattfanden. Das pip, mit dem Sie installiert haben, gehört zu einem anderen Python als das, mit dem Sie das Skript starten. Auf dem System liegen oft mehrere Pythons parallel – und jedes hat seine eigenen Pakete.
?Wie prüfe ich, welches Python wirklich läuft?
Mit which python und which pip (unter Windows: where). Zeigen beide in dieselbe Umgebung, passt es. Zeigt pip nach /usr/bin und python in Ihr venv, haben Sie die Erklärung. Der sicherste Weg ist ohnehin, Pakete mit python -m pip install zu installieren – dann kann das pip gar nicht das falsche sein.
Belege
Diese Seite ist gegen die folgenden Primärquellen geprüft – Hersteller, Standard oder Gesetzestext. Wer es nicht glaubt, muss es nicht: Da steht, wo es nachzulesen ist.
Python meldet ModuleNotFoundError, obwohl das Paket installiert ist? Meist stimmt die Umgebung, der Import-Name oder der Dateiname nicht. So löst du es.