So erstellen und aktivieren Sie eine virtuelle Python-Umgebung

Erfahren Sie, wie Sie mit dem integrierten venv-Modul eine virtuelle Python-Umgebung erstellen, aktivieren und verwalten. Halten Sie Ihre Projektabhängigkeiten isoliert und sauber.

Probieren Sie diese Lösung im Editor aus

Übersicht

Bei der Entwicklung von Python-Anwendungen installieren Sie häufig Pakete von Drittanbietern mit pip. Ohne eine virtuelle Umgebung werden diese Pakete global in der Python-Umgebung Ihres Systems installiert. Dies kann schnell zu Konflikten führen, wenn verschiedene Projekte unterschiedliche Versionen derselben Bibliothek erfordern (z. B. Projekt A benötigtDjango3.2 und Projekt B benötigtDjango5.0).

Eine virtuelle Umgebung ist ein isoliertes Verzeichnis, das seine eigene ausführbare Python-Datei und seinen eigenen Satz installierter Pakete enthält. Indem Sie für jedes Ihrer Projekte eine virtuelle Umgebung erstellen, stellen Sie sicher, dass Paketinstallationen andere Projekte oder das systemweite Python-Setup nicht beeinträchtigen. Dies ist eine grundlegende Best Practice für die Python-Entwicklung.

Im modernenPython 3enthält die Standardbibliothek das Modul „venv“, das virtuelle Umgebungen verwaltet, ohne dass externe Tools erforderlich sind. Der Lebenszyklus einer virtuellen Umgebung umfasst die Erstellung des Umgebungsverzeichnisses, dessen Aktivierung in Ihrer aktiven Terminalsitzung, die Installation von Abhängigkeiten und schließlich die Deaktivierung, wenn Sie fertig sind.

Code- und Ausführungsausgabe

Diese Simulation zeigt die Terminalbefehle, die zum Erstellen, Aktivieren, Installieren von Paketen in und Deaktivieren einer virtuellen Umgebung in macOS/Linux und Windows verwendet werden.

commands_macos_linux = """
# 1. Create a virtual environment named 'venv'
$ python3 -m venv venv

# 2. Activate the virtual environment
$ source venv/bin/activate

# 3. Verify activation (will show the path to the virtual env's python)
(venv) $ which python

# 4. Deactivate when done
(venv) $ deactivate
"""

commands_windows = """
# 1. Create a virtual environment named 'venv'
> python -m venv venv

# 2. Activate the virtual environment in Command Prompt
> venv\Scripts\activate

# 3. Or activate in PowerShell
> .\venv\Scripts\Activate.ps1

# 4. Deactivate when done
(venv) > deactivate
"""

print("macOS & Linux terminal commands:")
print(commands_macos_linux.strip())
print("\nWindows terminal commands:")
print(commands_windows.strip())
Terminal-Ausgabe
macOS & Linux terminal commands:
# 1. Create a virtual environment named 'venv'
$ python3 -m venv venv

# 2. Activate the virtual environment
$ source venv/bin/activate

# 3. Verify activation (will show the path to the virtual env's python)
(venv) $ which python

# 4. Deactivate when done
(venv) $ deactivate

Windows terminal commands:
# 1. Create a virtual environment named 'venv'
> python -m venv venv

# 2. Activate the virtual environment in Command Prompt
> venv\Scripts\activate

# 3. Or activate in PowerShell
> .\venv\Scripts\Activate.ps1

# 4. Deactivate when done
(venv) > deactivate

Schrittweise Umsetzung

  • Führen Sie python -m venv <env_name> in Ihrem Projektterminal aus, um die Umgebungsdateien zu generieren.
  • Aktivieren Sie die Umgebung mit der Quelle <env_name>/bin/activate (macOS/Linux) oder <env_name>\Scripts\activate (Windows).
  • Installieren Sie erforderliche Pakete mit pip install, um sicherzustellen, dass sie in diesem Projektverzeichnis isoliert sind.
  • Geben Sie in der Terminal-Shell „deaktivieren“ ein, um die virtuelle Umgebung zu verlassen, sobald Sie mit der Arbeit fertig sind.

Häufig gestellte Fragen

Wo soll ich den Ordner für die virtuelle Umgebung erstellen?

Erstellen Sie es direkt im Stammverzeichnis Ihres Projekts. Vermeiden Sie es, den Ordner der virtuellen Umgebung (z. B. venv/) an Git zu übergeben, indem Sie ihn Ihrer .gitignore-Datei hinzufügen.

Was bewirkt eigentlich die Aktivierung einer virtuellen Umgebung?

Durch die Aktivierung wird die PATH-Variable Ihrer Shell vorübergehend aktualisiert und auf den bin- oder Scripts-Ordner der virtuellen Umgebung verwiesen, sodass die lokalen ausführbaren Python- und Pip-Dateien anstelle der systemweiten ausgeführt werden.

Verwandte Themen

Empfohlene Python-Ressourcen

Erweitern Sie Ihr Wissen mit zugehörigen interaktiven Tutorials, Spickzetteln und Codevergleichen.