Virtuelle Python Umgebungen

By Jens Allmer

Virtuelle Umgebung in VS Code erstellen

Im Rahmen dieses ‘Pythonkurses’, wirst Du verschiedene Pythonmodule mit pip installieren. Diese Module gibt es in unterschiedlichen Versionen, und unter den Modulen gibt es komplexe Abhängigkeiten. Dadurch kann es sein, dass zwei Module nicht gleichzeitig installiert sein können. Um solche Probleme zu vermeiden gibt es virtuelle Umgebungen. Es ist deine Sache, aber ich würde für jedes neue Projekt eine neue virtuelle Umgebung erzeugen.

1. VS Code öffnen und Terminal starten

  • Öffne Visual Studio Code.
  • Öffne das Terminal mit:
    • Strg + ö (deutsche Tastatur)
    • Strg + Shift + P → “Toggle Terminal”

2. Neues Projektverzeichnis anlegen

Falls du dein Projekt noch nicht hast, erstelle einen neuen Ordner und navigiere dorthin:

mkdir mein_python_projekt cd mein_python_projekt

👉 Tipp: Falls du dein Projekt in VS Code öffnen willst:

code .

3. Virtuelle Umgebung erstellen

Führe folgenden Befehl im VS Code Terminal aus:

python -m venv venv

💡 Erklärung:

  • python -m venv venv erstellt einen neuen Ordner venv, der alle Python-Abhängigkeiten speichert.
  • "venv" ist der Standardname, aber du kannst ihn ändern (python -m venv myenv).
  • Anstelle von venv oder myenv wäre es besser aussagekräftige Namen zu wählen wie z.B. python -m venv pythonBuchKapitel1Aufgabe1

3️⃣ Virtuelle Umgebung aktivieren

🟢 Windows (CMD oder PowerShell)

  1. Falls du CMD benutzt:

    venv\Scripts\activate

  2. Falls du PowerShell benutzt:

    venv\Scripts\Activate.ps1

    ❗ Falls eine Fehlermeldung kommt („execution policy error“), versuche:

    Set-ExecutionPolicy Unrestricted -Scope Process

🔵 macOS & Linux

source venv/bin/activate

4️⃣ Überprüfen, ob die Umgebung aktiv ist

Falls die Aktivierung erfolgreich war, sollte sich der Prompt im Terminal ändern, z. B.:

(venv) C:\Users\Benutzer\mein_python_projekt>

👉 Das (venv) vor der Befehlszeile zeigt an, dass die virtuelle Umgebung aktiv ist.

5️⃣ Pakete in der virtuellen Umgebung installieren

  1. Beispiel: Installiere numpy und pandas

    pip install numpy pandas

  2. Überprüfen, welche Pakete installiert sind

    pip list

  3. Abhängigkeiten in einer Datei speichern (für Teamprojekte)

    pip freeze > requirements.txt

  4. Alle Abhängigkeiten aus einer Datei installieren

    pip install -r requirements.txt

6️⃣ Virtuelle Umgebung in VS Code nutzen

Falls VS Code nicht automatisch die virtuelle Umgebung erkennt:

  1. Öffne die Befehlspalette mit Strg + Shift + P.
  2. Suche nach “Python: Select Interpreter” und wähle es aus.
  3. Falls VS Code die virtuelle Umgebung nicht anzeigt:
    • Klicke auf “Enter interpreter path” → “Find…”.
    • Navigiere zu mein_python_projekt/venv/Scripts/python.exe (Windows) oder venv/bin/python (Linux/macOS).
    • Wähle diese Python-Version aus.

Nun nutzt VS Code automatisch die virtuelle Umgebung für das Projekt.

7️⃣ Virtuelle Umgebung deaktivieren

Falls du aus der virtuellen Umgebung aussteigen möchtest:

deactivate

Die Befehlszeile sieht dann wieder normal aus:

C:\Users\Benutzer\mein_python_projekt>

8️⃣ Virtuelle Umgebung löschen (optional)

Falls du die virtuelle Umgebung entfernen willst:

rm -rf venv # macOS/Linux rd /s /q venv # Windows

💡 Danach kannst du eine neue Umgebung mit python -m venv venv erstellen.

✅ Fazit

Jetzt weißt du, wie du eine virtuelle Umgebung in VS Code erstellst, aktivierst und verwaltest! 🎉
Falls du Fragen hast oder Fehler auftreten, speichere sie direkt in Obsidian und lass es mich wissen. 😊

Alle verfügbaren virtuellen Umgebungen auflisten

Virtuelle Umgebungen sind in der Regel innerhalb des Projektordners gespeichert. Um sie zu finden:

Überprüfen, ob du in einer virtuellen Umgebung bist

Führe im VS Code Terminal folgenden Befehl aus:

pip list

Falls nur sehr wenige Pakete aufgelistet werden (z. B. pip und setuptools), nutzt du vermutlich eine frische virtuelle Umgebung.

👉 Falls du sicherstellen willst, woher pip die Pakete lädt, benutze:

pip show pip

Erwartete Ausgabe:

Name: pip Version: 23.0.1 Location: C:\Users\Benutzer\mein_projekt\venv\Lib\site-packages

Hier kannst du den Pfad zur aktiven venv erkennen.

** Herausfinden, wo Python-Umgebungen installiert sind**

Falls du eine Liste aller Python-Umgebungen auf dem System möchtest:

🟢 Methode 1: where oder which verwenden

Führe diesen Befehl im VS Code Terminal aus:

  • Windows (CMD oder PowerShell):

    where python

  • macOS & Linux:

    which python

💡 Falls der Pfad ...\venv\Scripts\python.exe enthält, nutzt du eine virtuelle Umgebung.

🟢 Methode 2: pip config debug

Falls du pip konfiguriert hast, kannst du die Pfade deiner venv herausfinden:

pip config debug

Suche nach "site.USER_SITE", um herauszufinden, wo deine Python-Pakete installiert sind.

Mit pipenv alle virtuellen Umgebungen anzeigen

Falls du pipenv (eine Alternative zu venv) nutzt, kannst du installierte Umgebungen anzeigen:

pipenv --venv

Falls du eine Liste aller Projekte mit pipenv möchtest:

pipenv --where

✅ Fazit

  • pip listet nur installierte Pakete in der aktiven venv, aber nicht alle existierenden venv-Umgebungen.
  • where python (Windows) oder which python (Linux/macOS) zeigt, wo Python installiert ist.
  • pipenv --venv hilft, falls pipenv genutzt wird.
  • Falls du alle venvs suchst, nutze find oder Get-ChildItem

Übrigens

Ein venv brauchst Du natürlich nur anzulegen, wenn python module installiert werden sollen. Falls Du mit den Standardbibliotheken zufrieden bist, dann brauchst du nichts zu installieren und dann brauchst Du auch keine virtuelle Umgebung.



Support with Coindrop