pip-Fehler „Microsoft Visual C++ 14.0 or greater is required“: Lösungen

Warum pip beim Installieren einer Python-Bibliothek Microsoft Visual C++ verlangt und wie Sie den Fehler beheben – oft ganz ohne Compiler.

pip-Fehler „Microsoft Visual C++ 14.0 or greater is required“: Lösungen

Sie installieren eine Python-Bibliothek mit pip, und nach ein paar Fortschrittszeilen füllt sich das Terminal mit roten Meldungen, die ungefähr so enden:

error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/
      [end of output]
  ERROR: Failed building wheel for bibliotheksname
Failed to build bibliotheksname

Die Meldung schlägt vor, die C++-Entwicklungswerkzeuge von Microsoft zu installieren: mehrere Gigabyte Software. In den meisten Fällen ist das jedoch nicht die beste Lösung. In diesem Artikel sehen wir uns an, was der Fehler wirklich bedeutet, wie man die Ursache findet und wie man ihn behebt – angefangen bei den einfachsten Lösungen.

Was der Fehler bedeutet

Viele Python-Bibliotheken enthalten Teile in der Sprache C, damit sie schneller sind. Dieser Code muss kompiliert werden, also in ein vom Computer ausführbares Programm übersetzt. Die Autoren der Bibliotheken erledigen das meist für Sie und veröffentlichen auf PyPI, dem offiziellen Archiv der Python-Bibliotheken, fertige Pakete namens Wheels.

Der entscheidende Punkt: Ein Wheel mit kompiliertem Code gilt nur für

  • eine bestimmte Python-Version, zum Beispiel 3.14;
  • ein bestimmtes Betriebssystem und einen bestimmten Prozessor, zum Beispiel Windows 64 Bit.

Findet pip kein passendes Wheel für Ihre Kombination, lädt es den Quellcode herunter und versucht, ihn selbst zu kompilieren. Unter Windows braucht es dafür den C++-Compiler von Microsoft – fehlt er, erscheint der Fehler. Die Meldung bedeutet also nicht „Ihnen fehlt Visual C++“, sondern „für Ihre Konfiguration gibt es kein fertiges Paket“.

Die häufigsten Ursachen

  • Eine zu neue Python-Version. Das ist die häufigste Ursache. Wenn eine neue Version erscheint, wie Python 3.15 am 9. Oktober 2026, brauchen viele Bibliotheken Wochen oder Monate, um kompatible Wheels zu veröffentlichen. In der Zwischenzeit versucht pip zu kompilieren.
  • Eine zu alte Python-Version. Der umgekehrte Fall: Neuere Versionen einer Bibliothek veröffentlichen keine Wheels mehr für Python-Versionen ohne Support.
  • Eine alte oder im Projekt festgelegte Bibliotheksversion. Eine Datei requirements.txt, die eine veraltete Version erzwingt, hat unter Umständen keine Wheels für Ihr Python.
  • Ein weniger verbreiteter Prozessor oder ein seltenes System, zum Beispiel Windows auf ARM oder Python 32 Bit.
  • Eine indirekte Abhängigkeit. Manchmal scheitert nicht die Bibliothek, die Sie angefordert haben, sondern eine, die sie mitbringt.

So finden Sie heraus, welche Bibliothek scheitert

Lesen Sie die Ausgabe von oben: Suchen Sie nach Zeilen, die mit Building wheel for oder Failed building wheel for beginnen. Der dort genannte Name ist die Bibliothek, die pip zu kompilieren versucht. Oft ist es nicht die, die Sie installiert haben: Wer zum Beispiel uvicorn[standard] anfordert, lässt pip auch weitere optionale Bibliotheken installieren, und eine davon kann die ohne Wheel sein.

Prüfen Sie dann, welche Python-Version Sie verwenden:

python --version

So prüfen Sie, ob es ein Wheel für Ihr Python gibt

Öffnen Sie die Seite der Bibliothek auf pypi.org und klicken Sie auf Download files. Die Dateinamen enthalten Kürzel, die angeben, für welche Konfiguration sie erstellt wurden. Zum Beispiel:

bibliotheksname-1.2.0-cp314-cp314-win_amd64.whl
  • cp314 bedeutet CPython 3.14, also Python 3.14;
  • win_amd64 bedeutet Windows 64 Bit.

Gibt es in der Liste keine Datei für Ihre Version (zum Beispiel cp315, wenn Sie Python 3.15 verwenden), haben Sie die Ursache gefunden.

Lösung 1: pip aktualisieren

Das ist der erste Schritt, denn er dauert nur Sekunden: Eine alte pip-Version erkennt neuere Wheels möglicherweise nicht.

python -m pip install --upgrade pip

Wiederholen Sie dann die Installation der Bibliothek.

Lösung 2: eine unterstützte Python-Version verwenden

Hat die Bibliothek noch keine Wheels für Ihre Python-Version, ist die sauberste Lösung, die vorherige Version zu verwenden. Mit dem Python Install Manager unter Windows genügen wenige Befehle:

py install 3.14

Erstellen Sie dann die virtuelle Umgebung des Projekts mit dieser Version neu. Im Projektordner:

rmdir /s /q .venv
py -V:3.14 -m venv .venv
.venv\Scripts\activate
python -m pip install -r requirements.txt

Der erste Befehl löscht die alte Umgebung, die übrigen erstellen sie mit Python 3.14 neu und installieren die Bibliotheken erneut. Sie können beide Python-Versionen installiert lassen und in anderen Projekten die neuere verwenden.

In den allermeisten Fällen ist das die richtige Lösung: In wenigen Minuten ist das Problem gelöst, ohne dass Sie etwas Schweres installieren müssen.

Lösung 3: die Bibliothek aktualisieren

Ist im Projekt eine genaue Version der Bibliothek festgelegt, zum Beispiel bibliotheksname==1.0.3 in der Datei requirements.txt, versuchen Sie es mit einer neueren Version, die Wheels für Ihr Python haben könnte:

python -m pip install --upgrade bibliotheksname

Prüfen Sie anschließend, ob Ihr Programm noch funktioniert: Eine neue Hauptversion einer Bibliothek kann Änderungen mitbringen.

Lösung 4: optionale Abhängigkeiten vermeiden

Manche Bibliotheken bieten optionale „Extras“ an, die in eckigen Klammern angegeben werden, etwa uvicorn[standard]. Stammt die scheiternde Bibliothek aus einem dieser Extras und brauchen Sie es nicht, installieren Sie die Basisversion:

python -m pip install uvicorn

Lösung 5: pip nur Wheels verwenden lassen

Mit dieser Option versucht pip nie zu kompilieren: Gibt es eine Version der Bibliothek mit passendem Wheel, wählt es diese; andernfalls bricht es sofort mit einer klaren Meldung ab statt mit einem langen Kompilierfehler.

python -m pip install --only-binary :all: bibliotheksname

Das ist auch zur Diagnose nützlich: So wissen Sie sicher, ob das Problem ein fehlendes Wheel ist.

Lösung 6: die Microsoft C++ Build Tools installieren

Hilft keine der bisherigen Lösungen, etwa weil Sie wirklich eine Bibliothek brauchen, die keine Wheels für Windows veröffentlicht, können Sie den Compiler installieren. Das ist die Lösung, die die Fehlermeldung vorschlägt:

  • Laden Sie die Microsoft C++ Build Tools von der in der Meldung genannten Seite herunter.
  • Wählen Sie bei der Installation die Workload Desktopentwicklung mit C++ („Desktop development with C++“), die den MSVC-Compiler und das Windows SDK enthält.
  • Starten Sie danach den Computer neu, öffnen Sie ein neues Terminal, aktivieren Sie die virtuelle Umgebung und wiederholen Sie die Installation.

Bedenken Sie, dass die Installation mehrere Gigabyte belegt und dass manche Bibliotheken neben dem Compiler weitere Komponenten benötigen, die in ihrer Dokumentation angegeben sind.

Und unter Linux?

Unter Linux sieht der Fehler anders aus, meist mit Meldungen zu gcc oder zu Dateien wie Python.h, die Ursache ist aber dieselbe. Die Lösungen 1–5 gelten auch hier. Muss doch kompiliert werden, installieren Sie unter Ubuntu und Debian die Grundwerkzeuge:

sudo apt install build-essential python3-dev

Zusammengefasst

  • Der Fehler bedeutet, dass es kein fertiges Paket für Ihre Kombination aus Python und Betriebssystem gibt.
  • Die häufigste Ursache ist eine zu neue Python-Version.
  • Die schnellste Lösung ist, pip zu aktualisieren und, falls das nicht reicht, die vorherige Python-Version in einer neuen virtuellen Umgebung zu verwenden.
  • Die Build Tools sind das letzte Mittel, nicht das erste.

Offizielle Quellen

Teilen

Was ist Ihre Reaktion?

Gefällt mir Gefällt mir 0
Gefällt mir nicht Gefällt mir nicht 0
Liebe Liebe 0
Lustig Lustig 0
Wütend Wütend 0
Traurig Traurig 0
Wow Wow 0