Eine virtuelle Umgebung (englisch: virtual environment, kurz venv) ist ein abgeschlossener Bereich auf deinem Rechner, in dem eine eigene Python-Installation samt eigener Bibliotheken liegt. Alles, was du dort mit pip installierst, landet nur in dieser Umgebung und nicht in deiner systemweiten Python-Installation. Jedes Projekt bekommt so seine eigene, saubere Umgebung, die sich nicht mit anderen Projekten in die Quere kommt.
Spätestens wenn du Bibliotheken aus dem Internet benutzt (z.B. requests, PySide2 oder Django), solltest du mit virtuellen Umgebungen arbeiten. Mit einer virtuellen Umgebung kann ich:
- für jedes Projekt genau die Bibliotheken (und deren Versionen) installieren, die es braucht
- verhindern, dass sich zwei Projekte mit unterschiedlichen Versionsanforderungen gegenseitig stören
- meine systemweite Python-Installation sauber halten (manche Betriebssysteme verlassen sich darauf und verbieten deshalb
pip installaußerhalb einer Umgebung) - leicht nachvollziehbar machen, welche Bibliotheken mein Projekt benötigt, damit andere es ebenfalls zum Laufen bekommen
- eine kaputte Umgebung einfach löschen und neu anlegen, ohne das restliche System anzufassen
Du brauchst dafür nichts zu installieren: Das Modul venv ist seit Python 3.3 Teil der Standardbibliothek.
Wechsle zuerst in den Ordner deines Projektes und erzeuge dort die Umgebung. Üblicherweise nennt man den Ordner .venv:
python3 -m venv .venv # Linux / macOSpython -m venv .venv # WindowsDer Befehl python3 -m venv ruft das Modul venv auf und übergibt ihm den Namen des Ordners, der angelegt werden soll (hier .venv). In diesem Ordner liegt danach eine eigene Kopie des Python-Interpreters und ein eigener pip.
Falls python3 auf deinem System nicht gefunden wird, versuche es mit python, unter Windows ist das meistens der richtige Befehl.
Damit dein Terminal die Python-Installation aus der Umgebung benutzt (und nicht die des Systems), musst du die Umgebung aktivieren:
source .venv/bin/activate # Linux / macOS.venv\Scripts\Activate.ps1 # Windows (PowerShell)Sobald die Umgebung aktiv ist, stellt dir dein Terminal meistens ihren Namen in Klammern vor den Prompt:
(.venv) $Ab jetzt beziehen sich python und pip auf die Umgebung. Du kannst das überprüfen:
python --version
pip --versionHinweis für Windows: Sollte die Aktivierung mit einer Fehlermeldung zur Execution Policy abbrechen, erlaubt der folgende Befehl (einmalig, nur für deinen Benutzer) das Ausführen des Skriptes:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
Bei aktiver Umgebung installierst du Bibliotheken wie gewohnt mit pip. Sie landen dann ausschließlich in der Umgebung:
pip install requestsWelche Bibliotheken gerade installiert sind, zeigt dir:
pip listDamit andere (oder du auf einem anderen Rechner) genau dieselben Bibliotheken installieren können, schreibst du die aktuelle Liste in eine Datei namens requirements.txt:
pip freeze > requirements.txtDiese Datei gehört ins Projekt und sollte eingecheckt werden (siehe Versionskontrolle.md). Aus ihr lässt sich die Umgebung an anderer Stelle wiederherstellen:
pip install -r requirements.txtUm die Umgebung zu deaktivieren und wieder das System-Python zu benutzen, genügt:
deactivateEine virtuelle Umgebung ist nur ein Ordner. Du kannst sie bedenkenlos löschen und bei Bedarf neu erzeugen:
rm -r .venv # Linux / macOSRemove-Item -Recurse .venv # Windows (PowerShell)uv ist ein modernes, sehr schnelles Werkzeug, das die obigen Schritte - Umgebung anlegen und Pakete installieren - in wenigen Befehlen zusammenfasst. Es ist in der Programmiersprache Rust geschrieben und installiert Pakete um ein Vielfaches schneller als pip. Anders als venv gehört uv jedoch nicht zu Python und muss erst installiert werden.
Am einfachsten über das offizielle Installations-Skript:
curl -LsSf https://astral.sh/uv/install.sh | sh # Linux / macOSpowershell -c "irm https://astral.sh/uv/install.ps1 | iex" # Windows (PowerShell)Es gibt noch weitere Wege (z.B. über den Paketmanager deines Systems oder pip install uv); eine Übersicht findest du in der Installationsanleitung.
Mit uv sieht der Ablauf von oben so aus:
uv venv # legt eine Umgebung im Ordner .venv an
source .venv/bin/activate # aktivieren wie gewohnt (Windows: .venv\Scripts\Activate.ps1)
uv pip install requests # Pakete installieren - wie pip, nur schnellerPraktisch: Fehlt eine passende Python-Version auf deinem Rechner, lädt uv sie bei Bedarf automatisch herunter.
uv kann auch das ganze Projekt verwalten. Statt einer requirements.txt benutzt es dann die Datei pyproject.toml:
uv init mein-projekt # legt ein neues Projekt an
cd mein-projekt
uv add requests # Paket hinzufügen (wird in pyproject.toml vermerkt)
uv run python main.py # im Projekt ausführen - die Umgebung wird automatisch benutztIn diesem Fall kümmert sich uv selbst um die virtuelle Umgebung - du musst sie nicht von Hand aktivieren. Für den Anfang reicht python -m venv aber völlig; uv lohnt sich, sobald dich die Geschwindigkeit oder die Projektverwaltung reizt.
- Der Ordner
.venvgehört nicht in die Versionskontrolle – er ist groß, rechnerspezifisch und jederzeit aus derrequirements.txtwiederherstellbar. Trage ihn in deine.gitignoreein:.venv/ - Lege für jedes Projekt eine eigene Umgebung an.
- Die Umgebung muss in jedem neuen Terminal erneut aktiviert werden.
- Es gibt neben
venvnoch weitere Werkzeuge: das oben beschriebene uv sowie z.B. virtualenv oder Poetry. Für den Anfang reicht das mitgeliefertevenvaber vollkommen aus.