Einen Fehler bei der Paketinstallation lesen

Eine erfolgreiche Installation scrollt schnell vorbei. Eine fehlgeschlagene verdient langsameres Lesen, denn zwei Fehler, die beide mit rotem Text enden, erfordern unterschiedliche Maßnahmen.

Das Regal enthält dieses Paket nicht

Angenommen, du forderst auf der Website ein Paket außerhalb der geprüften Auswahl an. pip endet dann mit einer Meldung wie dieser:

python -m pip install rich==99.0.0

ERROR: Could not find a version that satisfies the requirement rich==99.0.0
ERROR: No matching distribution found for rich==99.0.0

Der entscheidende Ausdruck ist no matching distribution. Er bedeutet, dass der konfigurierte Index keine Datei enthält, die zum angeforderten Namen, zur Version, zu Python und zum Betriebssystem passt. Prüfe auf dieser Website zuerst die bereitgestellte direkte Auswahl: requests 2.34.2, pytest 9.1.1 und uv 0.12.3. Prüfe dann die Schreibweise und die genaue Version in deinem Befehl.

Wenn das Paket nicht in dieser Auswahl enthalten ist, höre dort auf. Füge keinen zweiten Index hinzu und richte die Sandbox nicht auf PyPI aus. Ein öffentlicher Ausweichweg ist absichtlich nicht verfügbar, und eine andere URL würde der Sandbox ohnehin keinen öffentlichen Netzwerkzugriff geben. Verwende das Paket, das die Lektion nennt, oder wende dich an den Kurssupport, falls die Lektion selbst etwas verlangt, das der Spiegelserver nicht bereitstellt.

Das Regal ist nicht erreichbar

Ein anderer Fehler wiederholt Verbindungsversuche und enthält Formulierungen wie diese:

WARNING: Retrying after connection broken by 'NewConnectionError'
ERROR: Could not connect to the package index

Das ist kein Beleg dafür, dass requests verschwunden ist. Es bedeutet, dass pip den konfigurierten Dienst nicht erreichen konnte. Prüfe, ob Paketname und Version zu den unterstützten Versionsfestlegungen gehören, warte kurz und versuche es einmal erneut. Bleibt derselbe Verbindungsfehler bestehen, melde, dass der Paketspiegel von Python Land offenbar nicht verfügbar ist. Deine Anforderungen umzuschreiben repariert keine Dienstverbindung.

Drei hilfreiche Prüffragen

Wenn eine Installation fehlschlägt, stelle dir diese Fragen in dieser Reihenfolge:

1. Ist der Paketname genau so geschrieben wie in der Lektion?

2. Gehören genau dieser Name und diese Version zur bereitgestellten Auswahl der Website?

3. Meldet die Ausgabe, dass es keinen Treffer gibt, oder spricht sie von Verbindung und erneutem Versuch?

Die ersten beiden Fragen führen dich zurück zu deinem Befehl. Die dritte kann zeigen, dass stattdessen die Plattform Aufmerksamkeit braucht.

Eine installierte Umgebung belegt, was jetzt funktioniert. Die nächste Lektion hält fest, was morgen wieder funktionieren soll.

Wenn eine Installation fehlschlägt und du die Meldung nicht einordnen kannst, kopiere die letzten Zeilen zu Monty und frage, welcher der beiden Fehler vorliegt. Ein Namensproblem und ein Dienstproblem sehen ähnlich aus und verlangen entgegengesetzte Reaktionen.