Symptom: Der Kurs verlangt requests, aber Ihr Terminal meldet „pip: command not found“ oder zeigt eine alte Python-Version.

Schnellste Lösung: Nicht zuerst Python neu installieren und nicht mit sudo erzwingen. Prüfen Sie den Interpreter, rufen Sie pip über Python 3.14 auf und erstellen Sie für das Kursprojekt eine venv.

Wer diese Reparaturanleitung braucht

Diese Anleitung ist für Sie gedacht, wenn Python 3.14 auf Ihrem Mac bereits installiert ist, pip aber fehlt, auf einen alten Pfad zeigt oder beim Installieren eine Fehlermeldung ausgibt.

Sie finden hier außerdem einen sicheren Weg bei Permission denied, externally-managed-environment, SSL-Problemen und fehlender Paketkompatibilität. Das gilt auch für Schulcomputer ohne Administratorrechte und für einen entfernten Mac, den Sie nur für Ihr Kursprojekt verwenden.

1. Den Fehler zuerst sichtbar machen

Ein typischer Fall sieht so aus: Sie installieren Python 3.14, öffnen danach ein neues Terminal und geben pip install requests ein. Das Terminal findet pip nicht. Oder pip --version zeigt einen Pfad zu einer älteren Python-Installation.

Das bedeutet nicht automatisch, dass die Installation beschädigt ist. Auf einem Mac können mehrere Python-Interpreter parallel vorhanden sein. PATH ist dabei wie ein Wegweiser: Er entscheidet, welches Programm Ihr Terminal bei einem kurzen Befehl zuerst findet. Der Befehl pip kann deshalb zu einer anderen Umgebung gehören als python3.14.

Führen Sie diese Prüfungen einzeln aus:

python3.14 --version
python3.14 -m pip --version
command -v python3.14
command -v pip

Die Versionsausgabe sollte Python 3.14 nennen. Die pip-Ausgabe sollte einen Pfad und eine Python-3.14-Umgebung anzeigen. Die offizielle Installationsdokumentation für Python 3.14 beschreibt die Zuordnung von Python und seinen Modulen; die pip-Dokumentation erklärt die Verwendung des Paketwerkzeugs.

Wichtig ist der Unterschied zwischen diesen beiden Aufrufen:

pip install requests
python3.14 -m pip install requests

Der zweite Aufruf sagt ausdrücklich: „Verwende pip aus genau diesem Python-Interpreter.“ Für die Fehlersuche ist er deshalb zuverlässiger. Wenn der zweite Befehl funktioniert, aber der erste nicht, liegt das Problem wahrscheinlich bei PATH oder bei einer alten pip-Verknüpfung.

Erfahrung aus der Fehlersuche: Installieren Sie nicht erneut, solange Sie nicht wissen, welcher Pfad tatsächlich verwendet wird. Eine zweite Installation kann die Zahl der Interpreter erhöhen und die Zuordnung noch unklarer machen.

2. pip fehlt, ist beschädigt oder wird nicht gefunden

Drei Symptome sehen ähnlich aus, brauchen aber unterschiedliche Schritte:

  • „command not found: pip“: Das Terminal findet den kurzen Befehl nicht. pip kann trotzdem in der Python-Installation vorhanden sein.
  • python3.14 -m pip meldet kein Modul: pip fehlt in genau diesem Interpreter oder ist dort nicht korrekt eingerichtet.
  • pip startet, zeigt aber einen alten Pfad: Der Shell-Befehl verweist auf eine andere Installation.

Prüfen Sie zuerst die sichere Variante:

python3.14 -m pip --version

Wenn Python 3.14 pip nicht findet, sehen Sie in der offiziellen Dokumentation zu ensurepip nach. Das Modul kann die mit Python bereitgestellte pip-Grundausstattung einrichten. Verwenden Sie dafür nur den Interpreter, den Sie bereits geprüft haben:

python3.14 -m ensurepip --upgrade
python3.14 -m pip --version

Die erwartete Abnahme besteht aus drei Teilen: pip gibt eine Versionsnummer aus, der Pfad gehört zur Python-3.14-Installation und der Befehl wird ohne Administratorrechte ausgeführt. Laden Sie keine Reparaturdatei aus einem Forum herunter und kopieren Sie keine unbekannten Shell-Skripte in Ihr Terminal.

Wenn python3.14 -m pip funktioniert, können Sie für die weitere Arbeit zunächst den vollständigen Aufruf verwenden. Das ist kein Fehler. Entscheidend ist, dass der Paketmanager im richtigen Werkzeugkasten liegt.

3. Mit venv Rechtefehler und externe Verwaltung vermeiden

Ein globaler Python-Bereich ist wie ein gemeinsam genutzter Klassenraum. Viele Projekte können dieselben Dateien verwenden. Wenn ein Kursprojekt dort beliebige Paketversionen ändert, kann ein anderes Projekt danach nicht mehr funktionieren.

Die Meldung externally-managed-environment weist genau auf diese Grenze hin. Eine von der System- oder Paketverwaltung kontrollierte Umgebung soll nicht einfach mit globalen pip-Befehlen verändert werden. Die Spezifikation zu extern verwalteten Python-Umgebungen erklärt diesen Schutz.

Erstellen Sie im Projektordner einen eigenen Arbeitstisch:

mkdir python-kurs
cd python-kurs
python3.14 -m venv .venv
source .venv/bin/activate
python --version
python -m pip --version

Nach der Aktivierung steht häufig (.venv) am Anfang der Terminalzeile. Das ist ein sichtbares Signal, dass Ihr Projekt nicht mehr den globalen Bereich verwendet. Die offizielle venv-Dokumentation beschreibt Erstellung und Aktivierung dieser isolierten Umgebung.

Installieren Sie danach das Kursabhängigkeitspaket:

python -m pip install requests

Beenden Sie die Umgebung mit:

deactivate

Beim nächsten Öffnen des Terminals müssen Sie in den Projektordner wechseln und die Umgebung erneut aktivieren:

cd python-kurs
source .venv/bin/activate

Vermeiden Sie als Anfänger diese scheinbaren Abkürzungen:

  • sudo pip install ...
  • Änderungen an geschützten Systemordnern
  • erzwungene Optionen, die den Schutz der Umgebung umgehen
  • Installation in einen Ordner, den Ihr Schulcomputer verwaltet

Der Nachteil einer venv ist ein zusätzlicher Aktivierungsschritt. Der Vorteil: Ihr Kursprojekt bleibt von anderen Projekten und der globalen Python-Installation getrennt.

4. SSL-, Zertifikats- und Netzwerkfehler unterscheiden

Nicht jeder Downloadfehler ist ein pip-Fehler. Lesen Sie die konkrete Meldung:

  • Zertifikatsfehler: Python kann die Identität des Downloadservers nicht prüfen.
  • Namensauflösung oder Verbindungsfehler: Das Netzwerk erreicht die Paketquelle nicht.
  • Proxy-Fehler: Das Schul- oder Unternehmensnetz erwartet einen Proxy.
  • Timeout: Die Verbindung ist unterbrochen oder wird gefiltert.
  • Fehler nur im Schulnetz: Die Richtlinie oder der Netzwerkzugang ist wahrscheinlich beteiligt.

Bei einer offiziellen macOS-Installation kann die Zertifikatseinrichtung Teil des Installationsablaufs sein. Prüfen Sie dafür die Python-Hinweise für macOS und folgen Sie ausschließlich den dort beschriebenen Schritten für Ihre Installation.

Sichere Reihenfolge:

  1. Kopieren Sie die vollständige Fehlermeldung.
  2. Prüfen Sie, ob andere Webseiten im gleichen Netzwerk erreichbar sind.
  3. Wiederholen Sie den Versuch in einem erlaubten, nicht eingeschränkten Netzwerk.
  4. Fragen Sie die Schulverwaltung nach Proxy- oder Zertifikatsvorgaben.
  5. Vergleichen Sie das Ergebnis mit einer freigegebenen Umgebung.

Schalten Sie die SSL-Prüfung nicht ab. Verwenden Sie auch keine Option, die Zertifikatsfehler einfach ignoriert. Damit verschwindet zwar möglicherweise die Meldung, aber die Identitätsprüfung des Servers wird geschwächt. Auf einem verwalteten Gerät dürfen Sie außerdem keine Schulrichtlinie umgehen.

5. „Keine passende Version“ und Build-Fehler richtig einordnen

Bei einer Meldung wie „No matching distribution found“ gibt es mehrere mögliche Ursachen:

  • Das Paket veröffentlicht noch keine Version für Python 3.14.
  • Für Ihre macOS- oder Prozessor-Kombination gibt es kein passendes wheel.
  • Der Kurs verlangt eine ältere Paketversion.
  • Die Paketquelle ist aus dem Netzwerk nicht erreichbar.
  • Ihr Befehl läuft in einer anderen Umgebung als gedacht.

Python 3.14.7 ist gemäß dem vorgegebenen Prüfstand eine veröffentlichte Wartungsversion der Python-3.14-Reihe. Ob ein einzelnes Paket diese Version unterstützt, folgt daraus jedoch nicht. Prüfen Sie immer die offizielle Projektseite und die Paketmetadaten auf PyPI, statt die Kompatibilität von einem anderen Paket abzuleiten.

Ein wheel ist vereinfacht gesagt ein fertiges Arbeitsblatt: pip muss den Code nicht erst auf Ihrem Mac zusammensetzen. Fehlt dieses fertige Paket, kann ein lokaler Build nötig werden. Die Erklärung zu Python-Paketformaten und die Spezifikation für Binary-Distribution-wheels beschreiben diesen Unterschied.

Gehen Sie so vor:

  1. Notieren Sie den Paketnamen und die verlangte Version.
  2. Prüfen Sie die offiziellen Veröffentlichungsnotizen des Pakets.
  3. Suchen Sie nach wheels für Ihre Python-Version und Apple-Silicon-Architektur.
  4. Vergleichen Sie die Kursvorgabe mit einer unterstützten Version.
  5. Installieren Sie nur eine dokumentierte Alternative.
  6. Wenn keine passende Version existiert, verwenden Sie die vom Kurs empfohlene Python-Version oder warten Sie auf eine kompatible Veröffentlichung.

Ein Build-Fehler ist kein guter Grund, wahllos Compiler, Fremdskripte oder Systembibliotheken zu installieren. Stoppen Sie, wenn die Paketdokumentation keine unterstützte Kombination nennt.

6. Den Editor und den Import gemeinsam prüfen

Eine Installation im Terminal beweist nicht, dass Ihr Editor denselben Interpreter verwendet. Das ist einer der häufigsten Gründe, warum ein Paket „installiert“ ist, aber import requests weiterhin fehlschlägt.

Aktivieren Sie zuerst die venv und führen Sie den Test mit demselben Python aus:

source .venv/bin/activate
python --version
python -m pip --version
python -c "import requests; print(requests.__version__)"

Wenn der Import funktioniert, wählen Sie im Editor den Interpreter aus, dessen Pfad in .venv/bin/python liegt. Die genaue Menübezeichnung kann je nach Entwicklungsumgebung abweichen. Entscheidend ist nicht das Aussehen des Editors, sondern der Interpreterpfad.

Testen Sie danach eine Datei im Kursprojekt:

import requests

print("Import erfolgreich")

Starten Sie sie aus der aktivierten Umgebung. Wenn das Terminal funktioniert, der Editor aber nicht, installieren Sie das Paket nicht erneut. Korrigieren Sie stattdessen die Interpreterauswahl.

Typische Fragen aus dem Kursalltag

Ist pip3 etwas anderes als pip?

pip, pip3 und ein versionierter Aufruf können auf unterschiedliche Installationen zeigen. Der Name allein beweist keine Zuordnung. Verwenden Sie für die Prüfung python3.14 -m pip --version und im aktivierten Projekt python -m pip --version. So ist sichtbar, welcher Interpreter den Paketmanager tatsächlich ausführt.

Braucht jedes Projekt eine eigene venv?

Eine eigene venv pro Kursprojekt ist meistens die übersichtlichste Lösung. Unterschiedliche Aufgaben können sonst inkompatible Paketversionen teilen. Wenn Ihr Kurs eine gemeinsame Umgebung ausdrücklich vorgibt, folgen Sie dieser Vorgabe. Bewahren Sie außerdem die Abhängigkeiten in einer dokumentierten Datei auf, damit die Installation später wiederholbar bleibt.

Was tun, wenn die Schule globale Installationen verbietet?

Arbeiten Sie in Ihrem Benutzerordner und verwenden Sie eine venv, sofern Python und Downloads erlaubt sind. Wenn auch das blockiert wird, fragen Sie die Verwaltung nach einem freigegebenen Weg. Ein Remote-Mac kann eine zeitweise Alternative sein, darf aber nicht dazu dienen, Schulrichtlinien oder Zugriffskontrollen zu umgehen.

Warum funktioniert der Import nach einem Neustart nicht mehr?

Nach dem Schließen des Terminals ist die venv nicht mehr aktiviert. Wechseln Sie wieder in den Projektordner und führen Sie source .venv/bin/activate aus. Prüfen Sie anschließend mit python -m pip --version, ob der Pfad erneut auf .venv zeigt. Erst danach sollten Sie das Kursprogramm starten.

Muss Python 3.14.7 für jedes Paket verwendet werden?

Nein. Python 3.14.7 ist eine Version der 3.14-Reihe, aber die Paketunterstützung muss einzeln geprüft werden. Maßgeblich sind die offiziellen Paketmetadaten und die Kursvorgaben. Wenn ein Paket Python 3.14 noch nicht unterstützt, ist eine dokumentierte Kursversion oft sicherer als ein erzwungener Build.

7. Die Reparatur mit einer Abnahme-Checkliste beenden

Arbeiten Sie die Liste erst ab, wenn Sie nicht mehr zwischen mehreren Terminalfenstern wechseln:

  • [ ] python3.14 --version zeigt die erwartete Python-3.14-Umgebung.
  • [ ] python3.14 -m pip --version zeigt pip und einen passenden Interpreterpfad.
  • [ ] Das Projekt besitzt einen eigenen Ordner mit .venv.
  • [ ] Die venv lässt sich aktivieren und mit deactivate wieder verlassen.
  • [ ] python -m pip install ... läuft ohne globale Rechteänderung.
  • [ ] Die installierte Paketversion steht in der richtigen venv.
  • [ ] Der Editor verwendet .venv/bin/python.
  • [ ] Ein minimaler import-Test funktioniert.
  • [ ] Sie können die Umgebung nach einem neuen Terminal wieder aktivieren.
  • [ ] Zertifikats- und Schulnetzfehler sind dokumentiert, statt umgangen zu werden.

Wenn einer dieser Punkte fehlt, ist die Umgebung noch nicht kursbereit. Besonders wichtig sind Pfad und Interpreter: Ein erfolgreicher Download in die falsche Umgebung löst das eigentliche Problem nicht.

Entscheidung vor der nächsten Installation

Die folgende Übersicht hilft Ihnen, den nächsten Schritt nicht nach Gefühl auszuwählen:

Beobachtung Wahrscheinliche Ursache Niedrigrisiko-Schritt Stoppen, wenn …
pip wird nicht gefunden PATH oder anderer Interpreter python3.14 -m pip --version prüfen Python 3.14 selbst nicht startet
pip zeigt einen alten Pfad Mehrere Python-Installationen versionierten Interpreter verwenden der Pfad nicht nachvollziehbar ist
externally-managed-environment globaler Bereich geschützt .venv erstellen und aktivieren die Verwaltung auch Benutzerordner sperrt
Permission denied geschützter Ordner oder fehlende Rechte im Projektordner ohne sudo arbeiten nur ein Admin die Installation ändern darf
SSL- oder Proxy-Fehler Zertifikat oder Schulnetz Richtlinie und erlaubtes Netzwerk prüfen Zertifikate deaktiviert werden müssten
kein passendes wheel Paket unterstützt Kombination nicht offizielle Paketdaten und Kursversion prüfen nur ein erzwungener Build möglich wäre

Für Schülergeräte ist außerdem die Umgebungswahl relevant:

Situation Lokaler Mac Schulcomputer Temporärer Remote-Mac
Administratorrechte häufig verfügbar, aber nicht für globale pip-Installationen nötig oft eingeschränkt von der bereitgestellten Umgebung abhängig
Wiederholbarkeit hoch bei dokumentierter venv kann durch Verwaltung begrenzt sein hoch, wenn Sie den Projektordner sauber einrichten
Netzwerk eigenes Netzwerk nutzbar Proxy oder Filter möglich Rechenzentrumsnetz kann abweichende Regeln haben
Geeignet für regelmäßige lokale Entwicklung einfache Kursübungen mit freigegebenen Tools Fristen, Tests und macOS-spezifische Aufgaben
Nachteil Anschaffung und Wartung des Geräts Rechte- und Zertifikatsprobleme Fernzugriff und Sitzungsverwaltung

Wenn Ihr eigener Mac eine saubere venv zulässt, gibt es keinen Grund, nur wegen eines pip-Fehlers sofort die Umgebung zu wechseln. Anders ist es, wenn ein Schulcomputer globale Ordner schützt, der Netzwerkzugang Zertifikate blockiert oder das Paket für die vorhandene Architektur nicht verfügbar ist.

Wann ein sauberer Remote-Mac sinnvoller ist

Ihr aktueller Schulcomputer hat drei reale Nachteile: Sie können möglicherweise keine Zertifikate oder Interpreterpfade korrigieren, Netzwerkregeln können Paketdownloads verhindern, und mehrere Schüler oder Kurse können dieselbe verwaltete Umgebung beeinflussen. Auch ein lokaler Mac ist nicht automatisch besser, wenn bereits alte Python-Installationen und unklare PATH-Einträge vorhanden sind.

Wenn der Abgabetermin näher rückt, kann es sinnvoll sein, das identische Kursprojekt vorübergehend auf einem sauberen, echten Mac zu prüfen: Python 3.14 auswählen, .venv anlegen, pip über den aktiven Interpreter ausführen und den Import testen. Bei MACCOME können Sie dafür eine Remote-Mac-Umgebung prüfen, ohne sofort ein eigenes Gerät anzuschaffen. Das ersetzt keine Paketkompatibilitätsprüfung und ist für dauerhaft schwere Arbeitslasten oder benötigte physische Anschlüsse nicht automatisch die beste Lösung.

Wenn Sie dagegen regelmäßig programmieren, viele Stunden offline arbeiten oder dauerhaft auf USB-Geräte und lokale Dateien angewiesen sind, ist ein eigener Mac wie ein Mac mini für die lokale Entwicklung langfristig bequemer. Für eine kurzfristige Kursprüfung zählt hingegen vor allem, dass Interpreter, venv und Import reproduzierbar funktionieren. Fehlt diese Grundlage auf Ihrem Schulgerät, wechseln Sie lieber kontrolliert die Umgebung, statt den globalen Python-Bereich mit sudo weiter zu beschädigen.