Tutorials

Anleitung: Python-Interpreter in Spyder mit einer virtuellen Umgebung (venv) unter Windows 10 einrichten

Melden

Diese Anleitung führt Sie Schritt für Schritt durch den Prozess, wie Sie eine bestehende virtuelle Python-Umgebung (virtual environment / venv) als Standard-Interpreter in der Entwicklungsumgebung Spyder unter Windows 10 festlegen.

Schritt 1: Das Paket spyder-kernels in der virtuellen Umgebung installieren

Damit Spyder mit einer externen virtuellen Umgebung kommunizieren kann, muss in dieser Umgebung zwingend das Paket spyder-kernels installiert sein.

  1. Öffnen Sie die Eingabeaufforderung (CMD) oder die PowerShell in Windows 10.

  2. Aktivieren Sie Ihre virtuelle Umgebung:

    C:\Pfad\zu\Ihrer\Umgebung\Scripts\activate

    (Ersetzen Sie den Pfad durch den tatsächlichen Pfad Ihres venv-Ordners. Nach der Aktivierung steht der Name der Umgebung in Klammern am Anfang der Zeile, z. B. (mein_venv)).

  3. Installieren Sie das erforderliche Modul mit folgendem Befehl:

    pip install spyder-kernels

    (Hinweis: Schließen Sie die Eingabeaufforderung danach noch nicht).

Schritt 2: Den Pfad zur python.exe der virtuellen Umgebung kopieren

Spyder benötigt den direkten Pfad zur ausführbaren Python-Datei innerhalb Ihrer virtuellen Umgebung.

  1. Geben Sie in der noch aktiven Eingabeaufforderung folgenden Befehl ein:
    where python
  2. Es werden Ihnen ein oder mehrere Pfade angezeigt. Kopieren Sie den obersten Pfad, der auf Ihre virtuelle Umgebung verweist. Er sieht typischerweise so aus: C:\Pfad\zu\Ihrer\Umgebung\Scripts\python.exe

Schritt 3: Den Interpreter in Spyder ändern

Nun verknüpfen Sie diesen Pfad in Spyder:

  1. Starten Sie Spyder.
  2. Klicken Sie in der oberen Menüleiste auf Tools (bzw. Werkzeuge) und wählen Sie Preferences (bzw. Einstellungen).
    (Alternativ Tastenkombination: Strg + Alt + P)
  3. Klicken Sie im linken Menü auf den Reiter Python interpreter (bzw. Python-Interpreter).
  4. Wählen Sie auf der rechten Seite die Option:
    🔘 Use the following Python interpreter (Folgenden Python-Interpreter verwenden).
  5. Fügen Sie in das Textfeld den in Schritt 2 kopierten Pfad ein (oder klicken Sie auf das Ordner-Symbol daneben und navigieren Sie manuell zur Datei python.exe im Unterordner Scripts Ihrer virtuellen Umgebung).
  6. Klicken Sie unten rechts auf Apply (Anwenden) und dann auf OK.

Schritt 4: Die Konsole neu starten und testen

Damit die Änderungen wirksam werden, muss die IPython-Konsole in Spyder neu geladen werden.

  1. Gehen Sie in Spyder unten rechts zum Fenster der IPython-Konsole.
  2. Klicken Sie auf das Menü-Symbol (die drei Querstriche oder das Zahnrad oben rechts im Konsolen-Fenster) und wählen Sie Restart kernel (Kernel neu starten), oder drücken Sie Strg + ..
  3. Testen Sie, ob der richtige Interpreter verwendet wird. Geben Sie dazu folgenden Code in die Konsole ein und drücken Sie Enter:
    import sys
print(sys.executable)
  4. Die Ausgabe sollte nun genau auf die python.exe in Ihrem virtuellen Umgebungsordner (...\Scripts\python.exe) verweisen.

Ab jetzt führt Spyder alle Skripte und Befehle isoliert über die Pakete aus, die in Ihrer virtuellen Umgebung installiert sind.

0