Virtuelle Python-Umgebungen mit venv: was sie sind und wie man sie nutzt

Was eine virtuelle Python-Umgebung ist, warum Sie sie in jedem Projekt nutzen sollten und wie Sie sie mit venv unter Windows und Linux erstellen, aktivieren und verwalten.

Virtuelle Python-Umgebungen mit venv: was sie sind und wie man sie nutzt

Sobald man Python ernsthaft nutzt, stößt man auf ein Problem: Jedes Projekt braucht seine eigenen Bibliotheken, manchmal in unterschiedlichen Versionen. Ein Skript verlangt eine bestimmte Version einer Bibliothek, ein anderes Projekt eine neuere – und wer alles an derselben Stelle installiert, landet früher oder später bei schwer verständlichen Konflikten.

Die Lösung heißt virtuelle Umgebung. In dieser Anleitung sehen wir uns an, was das ist, warum es sich lohnt, sie immer zu verwenden, und wie man sie mit venv, dem in Python enthaltenen Werkzeug, unter Windows und Linux verwaltet.

Was ist eine virtuelle Umgebung?

Eine virtuelle Umgebung ist ein Ordner mit einer isolierten Kopie von Python und eigenen Bibliotheken. Ist die Umgebung aktiv, landet alles, was Sie installieren, dort – und nicht im allgemeinen Python des Computers.

Man kann sie sich wie einen Werkzeugkasten für eine einzelne Aufgabe vorstellen: Jedes Projekt hat seinen eigenen, mit genau den Werkzeugen, die es braucht, und die Kästen vermischen sich nicht.

Es gibt drei konkrete Vorteile:

  • Keine Konflikte: Zwei Projekte können unterschiedliche Versionen derselben Bibliothek nutzen.
  • Das System bleibt sauber: Gerade unter Linux riskieren Sie nicht, das vom Betriebssystem genutzte Python zu beschädigen.
  • Das Projekt ist reproduzierbar: Sie können dieselbe Umgebung mit einem einzigen Befehl auf einem anderen Computer oder einem Server neu erstellen.

Bevor Sie beginnen

Sie brauchen ein bereits installiertes Python. Stellen Sie unter Ubuntu und Debian außerdem sicher, dass das Modul venv vorhanden ist, das nicht immer mitinstalliert wird:

sudo apt install python3-venv

Unter Windows ist venv bereits enthalten, wenn Sie Python mit dem Python Install Manager installiert haben.

Eine virtuelle Umgebung erstellen

Öffnen Sie das Terminal im Ordner Ihres Projekts und geben Sie ein:

# Windows
python -m venv .venv

# Linux und macOS
python3 -m venv .venv

Der Befehl erstellt einen Ordner namens .venv mit allem Nötigen. Der Name ist eine weit verbreitete Konvention: Der Punkt am Anfang macht ihn unter Linux „versteckt“, und die meisten Editoren erkennen ihn automatisch. Sie können ihn beliebig benennen, aber .venv ist die bequemste Wahl.

Haben Sie unter Windows mehrere Python-Versionen installiert, können Sie wählen, mit welcher die Umgebung erstellt wird:

py -V:3.14 -m venv .venv

Die Umgebung verwendet immer die Version, mit der sie erstellt wurde.

Die Umgebung aktivieren

Das Erstellen allein reicht nicht: Sie müssen die Umgebung aktivieren, jedes Mal wenn Sie ein neues Terminal öffnen, um am Projekt zu arbeiten. Der Befehl hängt vom System ab:

# Windows, Eingabeaufforderung
.venv\Scripts\activate

# Windows, PowerShell
.venv\Scripts\Activate.ps1

# Linux und macOS
source .venv/bin/activate

Ist die Umgebung aktiv, erscheint ihr Name in Klammern am Anfang der Terminalzeile, zum Beispiel (.venv). Das ist das Zeichen, dass Sie innerhalb der Umgebung arbeiten.

Blockiert PowerShell das Aktivierungsskript mit einem Fehler zu den Ausführungsrichtlinien, erlauben Sie die Ausführung lokaler Skripte für Ihren Benutzer mit diesem Befehl, den Sie nur einmal ausführen müssen:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Bibliotheken installieren

Bei aktiver Umgebung werden Bibliotheken mit pip installiert, dem Paketmanager von Python:

python -m pip install requests

Warum python -m pip und nicht einfach pip? Weil Sie so sicher sind, dass pip die Bibliothek genau in das Python installiert, das Sie gerade verwenden. Mit dem Befehl pip allein könnte die Bibliothek am falschen Ort landen, wenn die Umgebung nicht aktiv ist oder mehrere Versionen installiert sind. Eine kleine Gewohnheit, die viele Probleme erspart.

So sehen Sie die in der Umgebung installierten Bibliotheken:

python -m pip list

Abhängigkeiten mit requirements.txt speichern und wiederherstellen

Die von einem Projekt verwendeten Bibliotheken heißen Abhängigkeiten. Um ihre Liste mit den genauen Versionen zu speichern, verwendet man eine Datei namens requirements.txt:

python -m pip freeze > requirements.txt

Auf einem anderen Computer oder dem Server genügt es, eine neue virtuelle Umgebung zu erstellen, sie zu aktivieren und alles mit einem einzigen Befehl zu installieren:

python -m pip install -r requirements.txt

Die Datei requirements.txt gehört zum Projektcode. Der Ordner .venv dagegen wird weder kopiert noch in Git aufgenommen: Er enthält Pfade, die an Ihren Computer gebunden sind, und lässt sich in Sekunden neu erstellen. Wenn Sie Git verwenden, fügen Sie diese Zeile in die Datei .gitignore ein:

.venv/

Eine Umgebung deaktivieren und löschen

Um die virtuelle Umgebung zu verlassen, geben Sie einfach ein:

deactivate

Um sie vollständig zu löschen, entfernen Sie einfach den Ordner .venv. Es gibt nichts zu deinstallieren: Alles, was sie enthielt, lag in diesem Ordner.

Das ist auch nützlich, wenn Sie bei einem Projekt die Python-Version wechseln möchten: Ordner löschen, Umgebung mit der neuen Version neu erstellen und die Abhängigkeiten aus requirements.txt neu installieren.

Die Umgebung mit Visual Studio Code nutzen

Wenn Sie Visual Studio Code mit der Python-Erweiterung verwenden, erkennt der Editor den Ordner .venv meist von selbst. Falls nicht, öffnen Sie die Befehlspalette mit Ctrl+Shift+P, suchen Sie Python: Select Interpreter und wählen Sie den Interpreter im Ordner .venv. Ab dann aktiviert auch das integrierte Terminal die Umgebung automatisch.

Häufige Fehler und Lösungen

  • „ModuleNotFoundError: No module named …“: Fast immer ist die Umgebung nicht aktiv oder die Bibliothek wurde in ein anderes Python installiert. Aktivieren Sie die Umgebung und installieren Sie die Bibliothek mit python -m pip install neu.
  • „error: externally-managed-environment“ unter Linux: Sie versuchen, eine Bibliothek in das System-Python zu installieren. Erstellen und aktivieren Sie eine virtuelle Umgebung und wiederholen Sie die Installation darin.
  • „The virtual environment was not created successfully because ensurepip is not available“ unter Ubuntu oder Debian: Das Paket python3-venv fehlt. Installieren Sie es mit sudo apt install python3-venv, löschen Sie den unvollständigen Ordner .venv und erstellen Sie die Umgebung neu.
  • Die Umgebung funktioniert nicht mehr, nachdem der Projektordner verschoben oder umbenannt wurde: Virtuelle Umgebungen enthalten absolute Pfade und vertragen kein Verschieben. Löschen Sie sie und erstellen Sie sie neu.
  • Fehler „Microsoft Visual C++ 14.0 or greater is required“ beim Installieren einer Bibliothek: Meist wurde die Umgebung mit einer für diese Bibliothek zu neuen Python-Version erstellt. Wir haben diesem Fehler einen eigenen Artikel gewidmet.

Ein Blick auf alternative Werkzeuge

Neben venv gibt es umfassendere Werkzeuge wie uv oder Poetry, die Umgebungen, Abhängigkeiten und Python-Versionen in einem Zug verwalten. In größeren Projekten sind sie sehr beliebt. Für den Einstieg ist venv aber die beste Wahl: Es ist bereits in Python enthalten, funktioniert überall, und die hier gelernten Konzepte gelten auch für die anderen Werkzeuge.

Zusammenfassung

Der Arbeitsablauf jedes Python-Projekts lässt sich auf wenige Befehle reduzieren:

  • Einmalig: python -m venv .venv im Projektordner.
  • Jedes Mal, wenn Sie am Projekt arbeiten: die Umgebung aktivieren.
  • Um Bibliotheken hinzuzufügen: python -m pip install name, danach requirements.txt aktualisieren.
  • Auf einem anderen Computer: Umgebung erstellen, aktivieren und python -m pip install -r requirements.txt ausführen.

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