Wie erstellen Sie mit Python 3.15.1 eine virtuelle Umgebung für ein Kursprojekt? Einsteiger-Tutorial 2026

Das Terminal findet ein Paket nicht oder Ihre Kursaufgabe läuft mit einer anderen Python-Version als erwartet.
Schnellste Lösung: Prüfen Sie zuerst die Kursvorgabe, erstellen Sie im Projektordner eine eigene virtuelle Umgebung mit dem passenden Interpreter und installieren Sie die Projektabhängigkeiten ausschließlich dort.

Dieser Leitfaden ist für Sie, wenn Sie gerade mit Python anfangen und Ihre erste Kursaufgabe einrichten.
Er hilft Ihnen auch, wenn sich Abhängigkeiten mehrerer Projekte gegenseitig stören.
Wenn Sie überwiegend unter Windows arbeiten und dasselbe Projekt auf einem Mac fortsetzen müssen, finden Sie weiter unten einen sicheren Übergabeweg.

Zuletzt geprüft am 24.10.2026. Die Versionsangabe und das Veröffentlichungsdatum von Python 3.15.1 sind anhand der offiziellen Python-Veröffentlichungsseite geprüft; die Befehle zur virtuellen Umgebung anhand der Python-Dokumentation zu venv.

Kursvorgabe vor Interpreterwahl

Eine virtuelle Umgebung ist keine Python-Version-Auswahl, die Sie nachträglich beliebig umstellen können. Sie wird mit dem Python-Interpreter erstellt, den Sie beim Aufruf verwenden. Verlangt Ihr Kurs eine andere Version als Python 3.15.1, richten Sie sich nach dem Kurs und nicht nach dem neuesten verfügbaren Versionsstand.

Die Python-Veröffentlichungsseite führt Python 3.15.1 als am 21.10.2026 veröffentlicht. Das belegt, dass die Version veröffentlicht wurde; es belegt nicht, dass Ihr Kurs sie verlangt oder dass eine bestimmte Bibliothek damit funktioniert. Prüfen Sie deshalb vor der Einrichtung das Aufgabenblatt, die Kursplattform und vorhandene Projektdateien. Die Dokumentation zu Python 3.15 und venv beschreibt die Umgebungserstellung für diese Dokumentationsversion.

Prüfen Sie die vorhandenen Interpreter, bevor Sie die Umgebung erstellen. Auf macOS oder Linux können Sie beispielsweise python3.15 --version ausführen, sofern dieser Befehl auf Ihrem Rechner verfügbar ist. Unter Windows zeigt die offizielle Anleitung zur Python-Verwendung, wie Sie mit dem Python-Launcher eine installierte Version auswählen. Erhalten Sie eine Fehlermeldung, raten Sie nicht am Befehl weiter: Prüfen Sie, ob Python installiert ist und welcher Startbefehl auf Ihrem System funktioniert.

Der Name einer Umgebung wie .venv legt die Python-Version nicht fest. Entscheidend ist der Interpreter, der venv startet. Schreiben Sie sich daher vor dem Anlegen auf, welche Kursvorgabe Sie gefunden haben und mit welchem Interpreter Sie die Umgebung erzeugen wollen. So vermeiden Sie, dass Sie eine Umgebung mit einer Version erstellen, die zwar auf Ihrem Rechner verfügbar ist, aber nicht zur Aufgabe passt.

Achten Sie auch darauf, dass Kursunterlagen nicht immer am selben Ort liegen. Eine Versionsangabe kann im Aufgabenblatt stehen, während die Paketliste im Projektordner oder in einer zusätzlichen Einrichtungsdatei liegt. Prüfen Sie die Anweisungen vollständig, bevor Sie Pakete installieren. Falls die Kursvorgabe unklar ist, fragen Sie nach, bevor Sie Ihr Projekt auf eine andere Python-Version umstellen.

Projektordner und eigene Umgebung

Legen Sie die Umgebung im Verzeichnis des Kursprojekts an. Stellen Sie sich jedes Projekt wie einen eigenen Arbeitstisch vor: Auf einem Tisch liegen nur die Werkzeuge, die Sie für diese Aufgabe brauchen. Installieren Sie Pakete stattdessen global, landen die Werkzeuge verschiedener Projekte in derselben Schublade. Eine spätere Änderung für ein Projekt kann dann ein anderes unbeabsichtigt beeinflussen.

Öffnen Sie ein Terminal im Projektordner. Vergewissern Sie sich mit pwd auf macOS oder Linux beziehungsweise cd unter Windows, dass Sie am erwarteten Speicherort arbeiten. Erstellen Sie die Umgebung anschließend mit dem passenden Interpreter.

Diese Beispiele setzen voraus, dass der passende Interpreter bereits aufrufbar ist. Wenn Ihr Kurs eine andere Version verlangt, ersetzen Sie die Versionsauswahl durch den tatsächlich installierten und geforderten Interpreter. Der Python-Aufruf -m venv und die plattformspezifischen Aktivierungsbefehle sind in der offiziellen venv-Dokumentation beschrieben; für die Windows-Shells beachten Sie zusätzlich die Windows-Hinweise von Python.

Führen Sie die Erstellung nicht versehentlich eine Verzeichnisebene zu hoch aus. Sonst liegt .venv möglicherweise neben dem Kursprojekt statt darin. Eine einfache Kontrolle: Der Projektordner sollte Ihre Aufgaben-Dateien enthalten und nach dem Erstellen zusätzlich den Ordner .venv. Behalten Sie den Umgebungsordner nicht als Ersatz für den Quellcode oder die Kursunterlagen.

Wenn im Projekt bereits ein Ordner mit dem Namen .venv vorhanden ist, prüfen Sie erst, ob er zu dieser Aufgabe gehört, bevor Sie ihn löschen oder erneut erstellen. Ein vorhandener Ordner könnte eine bereits eingerichtete Umgebung enthalten. Ändern Sie ihn nicht, wenn Sie noch nicht wissen, welche Dateien darin liegen oder ob andere Projektmitglieder darauf angewiesen sind. Für die erste Einrichtung ist wichtig, dass Sie den tatsächlichen Projektpfad kennen und den Erstellungsbefehl dort ausführen.

Aktivierung und Interpreterkontrolle

Die Aktivierung verändert die Umgebung Ihres aktuellen Terminals, sodass der kurze Befehl python auf den Interpreter der Umgebung verweist. Die Aktivierung allein beweist aber noch nicht, dass Sie im richtigen Projekt oder mit dem gewünschten Interpreter arbeiten. Prüfen Sie den tatsächlich verwendeten Pfad.

Python dokumentiert unterschiedliche Aktivierungsskripte für verschiedene Plattformen und Shells. Kopieren Sie daher nicht einfach einen macOS-Befehl in PowerShell. Falls PowerShell die Aktivierung blockiert, prüfen Sie die verwendete Shell und folgen Sie den offiziellen Windows-Hinweisen, statt eine Systemeinstellung auf Verdacht zu ändern.

Wenn der Pfad nicht in .venv liegt, gehen Sie der Reihe nach vor: Ist das Terminal wirklich im Projektordner geöffnet? Haben Sie den Aktivierungsbefehl für die aktuelle Shell verwendet? Zeigt python nach der Aktivierung auf den erwarteten Interpreter? Für die Pfadprüfung stellt das Python-Modul sys die Variable sys.executable bereit. Damit sehen Sie den vollständigen Pfad des laufenden Python-Programms, nicht nur einen möglicherweise irreführenden Umgebungsnamen in der Eingabezeile.

Ein neues Terminalfenster übernimmt nicht automatisch die Aktivierung aus einem anderen Fenster. Aktivieren Sie die Umgebung daher erneut, wenn Sie eine neue Sitzung öffnen. Prüfen Sie außerdem, ob Ihr Editor oder Ihre Entwicklungsumgebung denselben Interpreter verwendet wie das Terminal. Wenn ein Skript im Terminal funktioniert, im Editor aber ein Paket fehlt, kann der Editor einen anderen Python-Interpreter ausgewählt haben. Vergleichen Sie dessen Interpreterpfad mit dem Ergebnis von sys.executable, bevor Sie ein Paket ein zweites Mal installieren.

Abhängigkeiten im Projekt installieren

Eine frisch erstellte virtuelle Umgebung enthält nicht automatisch alle Bibliotheken, die Ihre Aufgabe benötigt. Sie trennt die Installation vom restlichen System; welche Pakete gebraucht werden, bestimmt die Kursvorgabe oder das Projekt. Öffnen Sie daher zuerst die bereitgestellte Abhängigkeitsdatei oder lesen Sie die Installationsanweisung des Kurses.

Führen Sie die Installation nach der Aktivierung aus. Mit python -m pip koppeln Sie pip an den Interpreter, der über python aufgerufen wird. Das verringert das Risiko, ein Paket in einer anderen Python-Installation abzulegen. Die Installationsdokumentation von pip erläutert die Paket- und Dateiauswahl; das Format von requirements.txt beschreibt die Referenz zur Anforderungsdatei.

Halten Sie die Kursvorgabe ein, wenn sie bestimmte Pakete oder Schritte nennt. Eine requirements.txt ist eine Aufzeichnung von Anforderungen, aber nicht automatisch eine vollständige Beschreibung Ihrer gesamten Arbeitsumgebung. Wenn Sie Pakete ergänzen, notieren Sie, warum sie nötig sind, und prüfen Sie, ob der Kurs die Änderung erlaubt. Die pip-Benutzeranleitung erklärt den Umgang mit Paketinstallationen und Umgebungen.

Warten Sie mit der Installation, bis die Umgebung aktiviert ist. Falls die Ausgabe des Installationsbefehls auf einen globalen Pfad oder einen anderen Projektordner hinweist, stoppen Sie und prüfen Sie den Interpreterpfad. Installieren Sie nicht dieselbe Bibliothek wiederholt mit verschiedenen pip-Aufrufen, solange Sie nicht wissen, welches Python diese Befehle verwenden. So verhindern Sie, dass Sie das eigentliche Problem durch parallele Installationen schwerer nachvollziehbar machen.

FAQ zur Einrichtung

Umgebung für Python 3.15.1 erstellen

Öffnen Sie das Projektverzeichnis und verwenden Sie den passenden Interpreter mit -m venv .venv. Prüfen Sie vorher, ob der Kurs tatsächlich Python 3.15.1 verlangt; die Versionsnummer allein ist kein Grund für ein Upgrade. Aktivieren Sie die Umgebung danach mit dem Befehl für Ihre Shell und kontrollieren Sie mit sys.executable, ob der Pfad in das Projektverzeichnis führt.

Eigene Umgebung je Kursprojekt

Eine eigene Umgebung pro Projekt ist die verlässlichste Wahl, wenn die Aufgaben unterschiedliche Pakete oder Versionsvorgaben haben. Dadurch vermeiden Sie, dass eine Installation für eine Abgabe ein anderes Projekt verändert. Bei einer Übung ohne zusätzliche Abhängigkeiten können Sie den Aufwand abwägen; sobald der Kurs Pakete vorgibt, ist die getrennte Umgebung meist leichter nachzuvollziehen und erneut einzurichten.

Interpreter im Terminal kontrollieren

Führen Sie im aktivierten Terminal python -c "import sys; print(sys.executable)" aus. Der angezeigte Pfad sollte den .venv-Ordner Ihres aktuellen Projekts enthalten. Ist das nicht der Fall, prüfen Sie zuerst das Arbeitsverzeichnis, danach den Aktivierungsbefehl für Ihre Shell und schließlich den Python-Aufruf. Die Eingabeaufforderung kann einen Hinweis geben, ersetzt aber nicht diese Pfadkontrolle.

Kursabhängigkeiten in der Umgebung installieren

Aktivieren Sie zuerst die Projektumgebung. Installieren Sie anschließend das ausdrücklich verlangte Paket mit python -m pip install Paketname oder verwenden Sie eine vom Kurs bereitgestellte Datei mit python -m pip install -r requirements.txt. Wenn die Installation ohne sichtbare Fehlermeldung endet, testen Sie trotzdem den Import im Projekt: Erst dann wissen Sie, ob die Aufgabe den installierten Interpreter und das Paket tatsächlich erreicht.

Aufgabe ausführen und Fehler eingrenzen

Erst ein echter Projektlauf zeigt, ob Interpreter, Abhängigkeiten und Arbeitsverzeichnis zusammenpassen. Starten Sie nicht mit einem beliebigen Beispiel, wenn der Kurs einen konkreten Programmeinstieg vorgibt. Führen Sie stattdessen die kleinste dafür geeignete Aufgabe aus, etwa das bereitgestellte Skript oder den im Kurs genannten Startbefehl.

Gehen Sie in dieser Reihenfolge vor:

1. Öffnen Sie das Terminal im Verzeichnis des Projekts.
2. Aktivieren Sie dessen .venv mit dem Befehl für Ihr Betriebssystem und Ihre Shell.
3. Prüfen Sie mit python -c "import sys; print(sys.executable)", ob der Interpreter aus dieser Umgebung stammt.
4. Installieren Sie die ausdrücklich verlangten Abhängigkeiten, falls sie noch fehlen.
5. Starten Sie die Kursaufgabe und kontrollieren Sie, ob das erwartete Ergebnis erscheint.

Scheitert ein Import mit einer Meldung, dass ein Modul nicht gefunden wurde, installieren Sie nicht sofort erneut in mehreren Python-Installationen. Prüfen Sie zuerst, ob die Umgebung noch aktiv ist. Kontrollieren Sie danach den Interpreterpfad. Erst wenn beides stimmt, sehen Sie nach, ob das Paket laut Kursvorgabe installiert werden sollte und ob die Installation in diesem Terminal erfolgte.

Ein erfolgreicher Start allein ist kein Beleg dafür, dass Sie die richtige Projektumgebung verwenden: Ein Skript ohne zusätzliche Bibliotheken kann auch global laufen. Entscheidend ist die Kombination aus Interpreterpfad, erfolgreichem Import der benötigten Module und dem Ergebnis Ihrer tatsächlichen Aufgabe. Dokumentieren Sie besondere Startschritte, damit Sie sie bei einer späteren Sitzung wiederholen können.

Wenn die Aufgabe ein Ergebnis in einer Datei erzeugt, prüfen Sie auch, ob die Datei am erwarteten Ort landet. Ein korrekt gestartetes Skript kann dennoch aus dem falschen Arbeitsverzeichnis lesen oder schreiben. Verwenden Sie deshalb die Kursanweisung zum Startordner und kontrollieren Sie bei einem unerwarteten Ergebnis zuerst, wo sich Ihr Terminal befindet. Ändern Sie nicht gleichzeitig Interpreter, Abhängigkeiten und Projektpfad: Eine Änderung nach der anderen macht die Ursache deutlich leichter erkennbar.

Projekt auf einem Mac fortsetzen

Eine virtuelle Umgebung ist an den Interpreter und den Rechner gebunden, auf dem sie erstellt wurde. Kopieren Sie den Ordner .venv deshalb nicht als vermeintlich portable Projektdatei von Windows auf macOS. Erstellen Sie auf dem Zielrechner eine neue Umgebung und installieren Sie die benötigten Abhängigkeiten anhand der Kursvorgaben erneut. Die Python-Dokumentation zu venv beschreibt virtuelle Umgebungen als neu erstellbare, nicht einfach zwischen Rechnern übertragbare Umgebungen.

Übertragen Sie den Quellcode und die Projektunterlagen so, wie es Ihr Kurs vorsieht. Prüfen Sie vor dem Wechsel, ob eine vorhandene Abhängigkeitsdatei mitgegeben werden soll. Erstellen Sie auf dem Mac die Umgebung mit dem dort verfügbaren und für den Kurs passenden Interpreter, aktivieren Sie sie und kontrollieren Sie den Pfad erneut. Ein Projektordner kann gleich aussehen, während Terminal, Python-Aufruf und installierte Pakete auf dem Zielrechner andere sind.

Wenn Sie zunächst unter Windows lernen, brauchen Sie nicht allein deshalb einen Mac. Python-Grundlagen und viele Kursaufgaben lassen sich in Ihrer vorhandenen Umgebung bearbeiten. Die Grenze zeigt sich erst dann, wenn die konkrete Aufgabe macOS oder ein dort benötigtes Werkzeug voraussetzt. Eine macOS-virtuelle Maschine und ein Remote Mac sind außerdem unterschiedliche Wege; die Unterschiede bei Einrichtung und Nutzung erläutert unser Vergleich von macOS-VM und Remote Mac.

Übergabe-Checkliste

• [ ] Kursvorgabe für Python-Version und Abhängigkeiten notiert.
• [ ] Quellcode und Kursdateien getrennt von .venv gesichert.
• [ ] Auf dem Zielrechner eine neue Umgebung im Projektverzeichnis angelegt.
• [ ] Passenden Aktivierungsbefehl für das dort verwendete Betriebssystem gewählt.
• [ ] sys.executable geprüft und den Interpreterpfad bestätigt.
• [ ] Kursabhängigkeiten in der aktivierten Umgebung installiert.
• [ ] Die tatsächliche Aufgabe ausgeführt und das Ergebnis geprüft.

Vergessen Sie beim Wechsel auch nicht, private oder personenbezogene Daten aus Projektdateien zu entfernen, wenn sie für die Aufgabe nicht benötigt werden. Bei einem gemeinsam genutzten Rechner oder einer gehosteten Entwicklungsumgebung sollten Sie die geltenden Kurs- und Datenschutzregeln beachten. So übergeben Sie den Code, ohne Zugangsdaten oder persönliche Dateien unnötig mitzuschicken. Wenn Ihr Kurs Zugangsdaten in einer lokalen Konfigurationsdatei nutzt, prüfen Sie vor der Weitergabe, ob diese Datei wirklich zum Quellcode gehört. Geben Sie keine vertraulichen Angaben in eine öffentliche Abgabe oder ein gemeinsam genutztes Repository.

Nächster Schritt für Ihre Lernumgebung

Für gewöhnliches Python-Lernen ist ein eigener Mac keine Voraussetzung. Ihr vorhandener Windows-Rechner kann für den Kurs ausreichen; ein Wechsel auf macOS bringt zudem einen zusätzlichen Einrichtungs- und Übergabeschritt mit sich. Relevant wird ein Mac erst, wenn Ihre Aufgabe ausdrücklich eine Mac-Umgebung verlangt oder Sie Ihr Projekt dort prüfen müssen. Dann ist ein Remote Mac eine Option für den konkreten Test, ohne dass Sie sofort ein eigenes Gerät kaufen müssen.

Wenn genau dieser Bedarf bei Ihnen besteht, sehen Sie sich die Mac-Umgebung von MacDate an und prüfen Sie, ob sie zu Ihrer Kursaufgabe passt. Für ein einzelnes Projekt oder einen zeitlich begrenzten Mac-Test kann eine gemietete Umgebung sinnvoller sein als ein Gerät, das Sie außerhalb des Kurses kaum nutzen. Wenn Sie dauerhaft hohe lokale Auslastung oder bestimmte physische Anschlüsse benötigen, vergleichen Sie zuerst die Anforderungen mit einem eigenen Mac.