Skip to content

So beheben Sie den Fehler "Kein Modul namens Matplotlib" in Python

ModuleNotFoundError: Kein Modul namens 'matplotlib' ist ein häufiger Fehler, den Python-Entwickler beim Arbeiten mit Datenvisualisierung erleben. Es bedeutet, dass Python die Matplotlib-Bibliothek in Ihrer Umgebung nicht finden kann (Fehler 'Kein Modul namens Matplotlib'? Hier ist die Lösung – Kanaries (opens in a new tab)). Das Gute ist, dass dieser Fehler in der Regel relativ einfach zu beheben ist. In diesem Leitfaden erklären wir alle möglichen Ursachen des Fehlers und gehen Schritt für Schritt die Lösungen durch.

Wenn Sie ein Anfänger sind oder nur Ihre Umgebung debuggen, machen Sie sich keine Sorgen! Dieser Leitfaden ist in einem freundlichen, hilfsbereiten Ton geschrieben und hilft Ihnen, Matplotlib schnell zum Laufen zu bringen. Legen wir los!

Das Verständnis des Fehlers

Wenn Sie ModuleNotFoundError: Kein Modul namens 'matplotlib' sehen, teilt Python Ihnen mit, dass das matplotlib-Paket in der aktuellen Interpreter-Umgebung nicht verfügbar ist. Dies kann aus verschiedenen Gründen passieren:

  • Matplotlib ist nicht installiert: Die Bibliothek ist einfach nicht in Ihrer Umgebung vorhanden.
  • Mehrere Python-Versionen oder Umgebungen: Matplotlib ist möglicherweise in einem Python-Interpreter (oder virtuellen Umgebung) installiert, der nicht der ist, den Sie zum Ausführen Ihres Codes verwenden (So beheben Sie: Kein Modul namens matplotlib (opens in a new tab)).
  • Falscher Skriptaufruf (Hashbang-Probleme): Das direkte Ausführen eines Skripts (mit #!) könnte einen anderen Python-Versionsaufruf erzwingen, als Sie erwarten.
  • Falscher Python-Pfad oder Umgebungsvariablen: Python sucht möglicherweise an den falschen Orten nach Paketen.
  • Beschädigte Installation: Die Matplotlib-Installation ist möglicherweise defekt oder unvollständig.
  • Virtuelle Umgebung nicht aktiviert: Falls Sie eine virtuelle Umgebung oder Conda nutzen, ist diese möglicherweise nicht aktiv, sodass Matplotlib nicht zur Verfügung steht.
  • IDE- oder Jupyter-Konfiguration: Ihre IDE (PyCharm, VSCode, etc.) oder Jupyter Notebook verwendet eventuell eine andere Interpreter- oder Kernel-Version ohne Matplotlib.
  • Tippfehler oder Groß- und Kleinschreibung bei Import: Schreibfehler oder falsche Schreibweise im Importstatement können zum Fehler führen.
  • Namenskonflikte: Eine Datei oder ein Verzeichnis namens matplotlib in Ihrem Projekt könnte die echte Bibliothek verdecken.

Kurzübersicht: Ursachen & Lösungen

UrsacheLösung
Matplotlib ist nicht installiertInstallation mit pip install matplotlib bzw. conda.
Mehrere Python-Versionen/UmgebungenNutzung des richtigen Interpreters; Installation mit genau dieser Python-Variante (python -m pip install ...).
Falscher Hashbang (Skript nutzt falschen Python)Korrigieren Sie die #!-Zeile oder führen Sie das Skript explizit mit python3 script.py aus.
Falscher Python-Pfad / UmgebungsvariablenSicherstellen, dass sys.path das Installationsverzeichnis enthält; PYTHONPATH anpassen oder neu installieren.
Beschädigte InstallationDeinstallieren und neu installieren.
Virtuelle Umgebung nicht aktiviertAktivieren Sie die virtuelle Umgebung vor Nutzung; installieren in der aktivierten Umgebung.
IDE nutzt falschen InterpreterIn der IDE den richtigen Python-Interpreter einstellen.
Jupyter Kernel stimmt nicht übereinKernel auswählen oder installieren Sie Matplotlib im aktuellen Kernel.
Tippfehler bei Importimport matplotlib in Kleinschreibung verwenden.
Konflikt durch Dateien mit Namen matplotlibUmbenennen Ihrer Datei oder Verzeichnisse.

In den folgenden Abschnitten gehen wir auf jedes dieser Probleme einzeln ein, mit klaren Erklärungen und Lösungen.

Problem 1: Matplotlib ist nicht installiert

Der häufigste Grund für die Meldung "Kein Modulnamens Matplotlib" ist, dass die Matplotlib-Bibliothek nicht installiert ist. Ohne die Installation kann Python das Modul nicht finden – so einfach ist das.

Lösung: Matplotlib installieren

Um Matplotlib zu installieren, verwenden Sie den Python-Paketmanager pip (oder conda, wenn Sie Anaconda nutzen).

  • Mit pip: Öffnen Sie Ihr Terminal oder die Eingabeaufforderung und führen Sie aus:

    pip install matplotlib

    Falls Sie mehrere Python-Versionen installiert haben, müssen Sie möglicherweise pip3 verwenden oder explizit Python angeben:

    python3 -m pip install matplotlib

    Damit wird die neueste Version von Matplotlib aus dem Python-Paketindex (PyPI) in Ihre aktuelle Umgebung geladen und installiert (Saturn Cloud Blog: Jupyter ModuleNotFoundError Kein Modul namens Matplotlib (opens in a new tab)). Die Verwendung von python -m pip stellt sicher, dass Sie in derselben Python-Umgebung installieren, in der Sie später Ihren Code ausführen.

  • Mit conda: Falls Sie Anaconda/Miniconda nutzen, installieren Sie mit:

    conda install matplotlib

    Damit installieren Sie Matplotlib aus dem Anaconda-Repository in Ihre aktive conda-Umgebung (Saturn Cloud Blog (opens in a new tab)). Stellen Sie sicher, dass Ihre conda-Umgebung aktiv ist (conda activate your_env_name).

Nach der Installation prüfen: Starten Sie eine Python-Konsole und führen Sie aus:

import matplotlib
print(matplotlib.__version__)

Wenn diese Zeilen ohne Fehler durchlaufen und eine Versionsnummer ausgegeben wird, ist Matplotlib erfolgreich installiert. Falls der Import weiterhin fehlschlägt, lesen Sie die nächsten Abschnitte.

Problem 2: Mehrere Python-Versionen oder Umgebungen

Wenn Sie mehrere Python-Versionen oder virtuelle Umgebungen auf Ihrem Rechner haben, ist es möglich, dass Matplotlib in einer installiert ist, Sie den Code aber mit einer anderen Version ausführen. Das führt oft zu dem Fehler, obwohl die Bibliothek eigentlich vorhanden ist (Fehler 'No module named matplotlib' beheben (opens in a new tab)).

Lösung: Python-Interpreter und Installation aufeinander abstimmen

  1. Prüfen, welche Python-Version Ihr Script verwendet. In der Kommandozeile:
python --version

Oder in Python:

import sys
print(sys.executable)
print(sys.version)

Diese Ausgabe zeigt, welchen Python-Interpreter Sie nutzen.

  1. Prüfen, wo pip installiert.
pip --version

Hier sollte die Python-Version stehen, zu der pip gehört. Achten Sie darauf, dass sie mit der Python-Version stimmt, die Ihr Script nutzt.

  1. Matplotlib in die richtige Umgebung installieren.

Wenn Sie z.B. Python 3.10 verwenden, führen Sie aus:

python3.10 -m pip install matplotlib

oder

py -3.10 -m pip install matplotlib

auf Windows. Damit stellen Sie sicher, dass Matplotlib in die Umgebung installiert wird, die Sie tatsächlich verwenden.

  1. Vermeiden Sie 'pip' ohne Angabe. Nutzen Sie immer die direkte Python-Variante, um sicherzugehen, dass Sie in der richtigen Umgebung installieren.

  2. Nach Installation den richtigen Interpreter im Editor auswählen. Ein Beispiel: In VS Code den Interpreter auf den Pfad der conda- oder virtuellen Umgebung einstellen.

Tipp: Wenn Sie sich unsicher sind, in welcher Umgebung Sie gerade sind, vergleichen Sie die Pfade (sys.executable) und die installierten Pakete (pip list).

Problem 3: Falscher Script Hashbang / Interpreter beim Ausführen

Wenn Sie Ihr Python-Skript direkt ausführen (z.B. ./script.py), kontrolliert die erste Zeile (#!) den verwendeten Interpreter. Ein falscher Pfad oder eine nicht übereinstimmende Version kann dazu führen, dass Python eine andere Version nutzt, in der Matplotlib nicht installiert ist.

Lösung: Hashbang anpassen oder direkt Python verwenden

  1. Überprüfen Sie die erste Zeile Ihres Skripts:
#!/usr/bin/env python3

oder

#!/usr/bin/python
  1. Stellen Sie sicher, dass diese Zeile die richtige Python-Version angibt. Für Python 3 sollte z.B. #!/usr/bin/env python3 stehen.

  2. Alternativ: Führen Sie das Skript explizit mit Python aus:

python3 script.py

oder

python3.10 script.py

Diese Methode garantiert, dass der richtige Interpreter genutzt wird.

Zusammenfassung:

Der Hashbang bestimmt, welcher Python-Interpreter verwendet wird. Wenn die dort angegebene Version Matplotlib nicht enthält, tritt der Fehler auf. Anpassen auf die richtige Version löst das Problem.

Problem 4: Python sucht an den falschen Stellen (Umgebungsvariablen & sys.path)

Python durchsucht eine Reihe von Verzeichnissen (sys.path), um Module zu finden. Wenn Matplotlib installiert wurde, aber an einem Ort, der nicht in sys.path enthalten ist, kann Python es nicht finden.

Lösung: Python-Pfad überprüfen und anpassen

  1. Prüfen, wo Python nach Modulen sucht:
import sys
print(sys.path)

Stellen Sie sicher, dass das Verzeichnis, in dem Matplotlib installiert wurde (z.B. /home/user/.local/lib/python3.10/site-packages), aufgelistet ist.

  1. Wenn der Pfad fehlt:
  • Fügen Sie ihn temporär in Ihrem Skript hinzu:
import sys
sys.path.append('/pfad/zu/matplotlib')
import matplotlib
  • Oder setzen Sie die Umgebungsvariable PYTHONPATH entsprechend:

Auf Linux/macOS:

export PYTHONPATH=$PYTHONPATH:/pfad/zu/matplotlib

Auf Windows:

$env:PYTHONPATH="$env:PYTHONPATH;C:\pfad\zu\matplotlib"
  1. Optimal: Installieren Sie Matplotlib im Standardpfad indem Sie es mit dem richtigen Python-Interpreter neu installieren. Das ist die nachhaltigste Lösung.

Problem 5: Beschädigte oder unvollständige Installation

Manchmal ist die Installation defekt oder wurde unvollständig durchgeführt. Das kann dazu führen, dass Python das Modul zwar als installiert sieht, aber nicht importieren kann.

Lösung: Neuinstallation

  1. Deinstallieren Sie Matplotlib:
pip uninstall matplotlib
  1. Installieren Sie es erneut:
pip install matplotlib

Oder mit python -m pip:

python -m pip install --force-reinstall matplotlib
  1. Verifizieren Sie den Erfolg:
import matplotlib
print(matplotlib.__file__)

Wenn kein Fehler auftritt und Sie den Pfad sehen, ist alles in Ordnung.

Problem 6: Virtuelle Umgebung nicht aktiviert

Wenn Sie eine virtuelle Umgebung (z.B. mit venv oder conda) verwendet haben, aber diese nicht aktiv ist, sucht Python an der Stelle des globalen Interpreters, anstatt in Ihrer virtuellen Umgebung. Matplotlib könnte in der virtuellen Umgebung installiert sein, aber Ihre aktuelle Shell nutzt eine andere.

Lösung: Umgebung aktivieren

  • Venv (Unix/macOS):
source venv/bin/activate
  • Venv (Windows):
.\venv\Scripts\activate
  • Conda:
conda activate myenv

Stellen Sie sicher, dass nach Aktivierung pip list und which python (bzw. where python auf Windows) die richtigen Pfade anzeigen. Dann installieren Sie Matplotlib in dieser Umgebung:

pip install matplotlib

Führen Sie danach Ihr Script in der aktivierten Umgebung aus.

Problem 7: IDE nutzt den falschen Interpreter

Ihre Entwicklungsumgebung (IDLE, PyCharm, VS Code etc.) nutzt möglicherweise eine andere Python-Version oder -Umgebung, in der Matplotlib nicht installiert ist.

Lösung: IDE-Interpreter konfigurieren

  • PyCharm: Gehen Sie zu Settings > Project > Python Interpreter und wählen Sie den Interpreter, in dem Matplotlib installiert ist. Falls nötig, installieren Sie es direkt im Interpreter-Manager.

  • VS Code: Klicken Sie unten links auf den Interpreter-Namen oder verwenden Sie Strg+Shift+PPython: Interpreter auswählen, und wählen Sie die richtige Umgebung.

  • Andere IDEs: Suchen Sie die Einstellung für den Python-Interpreter und setzen Sie sie auf den richtigen Pfad.

Tipp: Testen Sie im Terminal innerhalb der IDE, ob import matplotlib funktioniert. Falls ja, ist alles richtig konfiguriert.

Problem 8: Jupyter Notebook Kernel stimmt nicht überein

In Jupyter-Notebooks ist der Kernel (also die Python-Umgebung, die läuft) manchmal nicht diejenige, in die Sie Matplotlib installiert haben. Das führt zu ModuleNotFoundError.

Lösung: Kernel auswählen oder installieren

  1. Kernel prüfen: Im Notebook:
import sys
print(sys.executable)

Vergleichen Sie den Pfad mit dem, in dem Sie Matplotlib installiert haben.

  1. Korrekte Kernel auswählen: Klicken Sie in Jupyter oben rechts auf den Kernelname, wählen Sie den Kernel, der mit Ihrer Umgebung übereinstimmt.

  2. Kernel installieren: Falls kein passender Kernel vorhanden ist, installieren Sie ipykernel in Ihrer Umgebung:

python -m ipykernel install --user --name=meineumgebung --display-name "Python (meineumgebung)"
  1. Matplotlib im aktuellen Kernel installieren:
%pip install matplotlib

nachdem Sie den richtigen Kernel ausgewählt haben. Danach Kernel neu starten, um sicherzustellen, dass die Änderung wirksam wird.

Problem 9: Tippfehler bei Import oder falsche Schreibweise

Der Name des Pakets ist exakt lowercase matplotlib. Schreibfehler wie import Matplotlib oder import matplotlibp führen zu Fehlern.

Lösung: Überprüfen Sie Ihren Import

  • Verwenden Sie:
import matplotlib
  • oder:
import matplotlib.pyplot as plt

Stellen Sie sicher, dass alles in Kleinbuchstaben geschrieben ist.

Problem 10: Namenskonflikte durch eigene Dateien

Wenn Ihr Projekt eine Datei matplotlib.py heißt oder eine Ordner mit diesem Namen existiert, kann Python versuchen, diese Datei zu importieren, statt der echten Bibliothek. Das führt zu Fehlern oder zu unerwarteten Effekten.

Lösung: Umbenennen Sie Ihre Dateien

  • Finden Sie alle Dateien/Ordner mit Namen matplotlib in Ihrem Projekt und benennen Sie diese um.

  • Löschen Sie eventuell .pyc-Dateien im Cache (__pycache__-Ordner).

  • Danach starten Sie Ihre Python-Session neu.

Das gibt Python die Chance, die richtige Matplotlib-Bibliothek zu importieren.


Zusammenfassung: Schritt-für-Schritt-Lösung

  1. Installieren Sie Matplotlib in der richtigen Umgebung:
python -m pip install matplotlib
  1. Überprüfen Sie, ob die Installation erfolgreich war:
import matplotlib
print(matplotlib.__version__)
  1. Stellen Sie sicher, dass Sie den richtigen Python-Interpreter/Kernel verwenden (IDE/Notebook/Script).

  2. Aktivieren Sie bei Bedarf Ihre virtuelle Umgebung.

  3. Passen Sie die Hashbang-Zeile Ihrer Skripte an.

  4. Prüfen Sie sys.path und PYTHONPATH, falls der Import weiterhin fehlschlägt.

  5. Vermeiden Sie Dateien mit Namen matplotlib im Projekt.

  6. Wenn Sie Jupyter verwenden, wählen Sie den korrekten Kernel bzw. installieren Sie Matplotlib im aktiven Kernel.

Mit diesen Schritten beheben Sie den Fehler zuverlässig. Und wenn Sie möchten, können Sie alternativ PyGWalker (opens in a new tab) nutzen, um Daten ganz ohne komplexe Programmierung zu visualisieren (PyGWalker Demo & Anleitung (opens in a new tab)). Viel Erfolg beim Visualisieren Ihrer Daten!