Tutorials

Python Virtual Environment in Visual Studio Code einrichten: Die vollständige Anleitung

Melden

Die Verwendung virtueller Umgebungen (Virtual Environments) gehört zu den wichtigsten Best Practices in der Python-Entwicklung. Sie stellt sicher, dass die Abhängigkeiten (Packages) deiner verschiedenen Projekte isoliert voneinander bleiben und keine Versionskonflikte im globalen System entstehen.

In diesem Tutorial erfährst du Schritt für Schritt, wie du eine virtuelle Python-Umgebung in Visual Studio Code (VS Code) erstellst, aktivierst und nutzt.

Voraussetzungen

Bevor du startest, stelle sicher, dass Folgendes auf deinem Computer installiert ist:

  1. Python (von python.org) – Wichtig: Bei Windows im Installer das Häkchen bei „Add Python to PATH“ setzen.
  2. Visual Studio Code (von code.visualstudio.com)
  3. Python-Erweiterung für VS Code (offizielle Extension von Microsoft, zu finden im Extensions-Tab von VS Code über das Tastenkürzel Strg+Umschalt+X bzw. Cmd+Shift+X).

Schritt 1: Projektordner vorbereiten

  1. Erstelle einen neuen Ordner auf deinem Computer für dein Projekt (z. B. mein-python-projekt).
  2. Öffne VS Code.
  3. Gehe auf Datei > Ordner öffnen... (File > Open Folder...) und wähle deinen Projektordner aus.

Schritt 2: Virtuelle Umgebung erstellen

Es gibt zwei Wege: Den modernen, automatisierten Weg direkt über VS Code (empfohlen) und den klassischen Weg über das Terminal.

Methode A: Der automatische Weg über die Befehlspalette (Empfohlen)

VS Code bietet eine integrierte Funktion, die die Umgebung erstellt und direkt für das Projekt als Standard setzt.

  1. Drücke Strg + Umschalt + P (Windows/Linux) oder Cmd + Shift + P (macOS), um die Befehlspalette zu öffnen.
  2. Tippe Folgendes ein und wähle es aus:
    Python: Create Environment...
  3. Wähle Venv (Verwendet das integrierte venv-Modul von Python).
  4. Wähle die gewünschte Python-Installation/Version aus, die als Basis dienen soll.
  5. VS Code erstellt nun im Hintergrund einen Ordner namens .venv in deinem Projektverzeichnis.
  6. Sobald der Vorgang abgeschlossen ist, ist die Umgebung bereits als aktiver Interpreter ausgewählt!

Methode B: Der manuelle Weg über das integrierte Terminal

Wenn du mehr Kontrolle bevorzugst, kannst du die Umgebung über die Konsole anlegen:

  1. Öffne das Terminal in VS Code über die Menüleiste (Terminal > Neues Terminal) oder per Tastenkürzel (Strg + ` bzw. Cmd + `).

  2. Führe den passenden Befehl für dein Betriebssystem aus:

    Windows:

    python -m venv .venv

    macOS / Linux:

    python3 -m venv .venv

    (Hinweis: Der Name .venv ist der Standardname. Durch den führenden Punkt ist der Ordner auf Unix-Systemen versteckt, was für Ordnung sorgt.)

  3. Interpreter in VS Code auswählen:

    • Drücke Strg + Umschalt + P (oder Cmd + Shift + P).
    • Suche nach: Python: Select Interpreter.
    • Wähle die Option aus, die deinen .venv-Pfad enthält (meist mit ('.venv': venv) gekennzeichnet).

Schritt 3: Virtuelle Umgebung im Terminal aktivieren

VS Code aktiviert die Umgebung in neu geöffneten Terminals meist automatisch.

  1. Schließe das aktuelle Terminal (Klick auf das Mülleimer-Symbol im Terminal-Panel).
  2. Öffne ein neues Terminal (Terminal > Neues Terminal).
  3. Prüfung: Du erkennst die aktive Umgebung daran, dass am Anfang der Befehlszeile der Name der Umgebung in Klammern steht:
    (.venv) PS C:\Pfad\zu\deinem\Projekt>

(Falls du das Terminal manuell aktivieren musst:)

  • Windows (PowerShell): .venv\Scripts\Activate.ps1
  • Windows (CMD): .venv\Scripts\activate.bat
  • macOS / Linux (Bash/Zsh): source .venv/bin/activate

Tipp für Windows-Nutzer bei Fehlermeldungen: Sollte der Fehler Die Datei ... Activate.ps1 kann nicht geladen werden, da die Ausführung von Skripts deaktiviert ist erscheinen, öffne die PowerShell als Administrator und tippe:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Schritt 4: Testen und Pakete installieren

Nun kannst du deine isolierten Pakete installieren, ohne dein Hauptbetriebssystem zu belasten.

  1. Erstelle eine neue Datei namens main.py im Projektordner.

  2. Installiere im aktiven Terminal ein beliebiges Paket (z. B. requests):

    pip install requests

  3. Füge folgenden Test-Code in main.py ein:

    import sys
import requests

print("Python Pfad:", sys.executable)
print("Requests Version:", requests.__version__)

  4. Klicke oben rechts auf den Play-Button (Run Python File) oder führe im Terminal python main.py aus.

  5. In der Ausgabe siehst du, dass der Python-Pfad direkt auf den .venv-Ordner verweist.

Wichtige Best Practices

  1. Version Control (.gitignore):
    Committest du dein Projekt via Git? Füge den Ordner .venv/ unbedingt zu deiner .gitignore-Datei hinzu. Virtuelle Umgebungen gehören niemals in das Git-Repository:

    # .gitignore
.venv/
__pycache__/

  2. Abhängigkeiten sichern:
    Wenn andere Entwickler (oder du auf einem anderen Rechner) dein Projekt nutzen wollen, erstelle eine Liste der installierten Pakete:

    pip freeze > requirements.txt

    Auf einem anderen System können diese dann einfach mit folgendem Befehl in eine neue .venv installiert werden:

    pip install -r requirements.txt
0