Auswählen einer Python Umgebung für ein Projekt in Visual Studio

Der gesamte Code in einem Python-Projekt wird im Kontext einer bestimmten Umgebung ausgeführt. Diese Umgebungen können eine globale Python Umgebung, eine Anaconda-Umgebung, eine virtuelle Umgebung oder eine Conda-Umgebung sein. Visual Studio verwendet die Python-Umgebung zum Debuggen, zum Import, zur Member-Vervollständigung und zur Syntaxprüfung. Die Umgebung wird für alle Aufgaben verwendet, die Sprachdienste erfordern, die für die Python-Version und eine Reihe von installierten Paketen spezifisch sind.

In Visual Studio können Sie mehrere Umgebungen für ein Projekt erstellen und je nach Ihren spezifischen Entwicklungsanforderungen zwischen ihnen wechseln. Alle neuen Python Projekte werden zunächst für die Verwendung der globalen Standardumgebung konfiguriert. Sie können die Umgebungen für Ihr Projekt unter dem Knoten Python Environments in Projektmappen-Explorer anzeigen:

Screenshot, der die globale Standard-Python-Umgebung für ein Projekt im Projektmappen-Explorer von Visual Studio anzeigt.

Screenshot, der die globale Python-Standardumgebung für ein Projekt im Projektmappen-Explorer in Visual Studio zeigt.

Voraussetzungen

Wechseln der aktuellen Projektumgebung

In Visual Studio können Sie die aktive (aktuelle) Umgebung für ein Python Projekt in Projektmappen-Explorer oder über die Symbolleiste ändern, indem Sie das Feature Add Environment verwenden.

  1. Starten Sie den Prozess "Umgebung hinzufügen" :

    • Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf den Knoten Python Umgebungen für Ihr Projekt, und wählen Sie Add Environment aus.
    • Oder wählen Sie auf der symbolleiste Python Add Environment aus dem Dropdownmenü Environment aus.

  2. Wählen Sie im Dialogfeld " Umgebung hinzufügen " die Registerkarte "Vorhandene Umgebung " aus. Erweitern Sie die Dropdownliste "Umgebung ", und wählen Sie ihre gewünschte Umgebung aus, und wählen Sie dann "Hinzufügen" aus.

    Screenshot, das zeigt, wie Sie eine Projektumgebung im Dialogfeld

Hinweis

Wenn die zu verwendende Umgebung nicht aufgeführt ist, müssen Sie möglicherweise eine vorhandene Umgebung manuell identifizieren.

Verwenden virtueller Umgebungen

Eine virtuelle Umgebung ist eine einzigartige Kombination aus einem bestimmten Python-Interpreter und einer bestimmten Gruppe von Bibliotheken, die sich von anderen globalen und Conda-Umgebungen unterscheiden. Eine virtuelle Umgebung ist spezifisch für ein Projekt und wird in einem Projektunterordner verwaltet. Der Ordner enthält die installierten Bibliotheken der Umgebung zusammen mit einer Pyvenv.cfg-Datei , die den Pfad zum Basisdolmetscher der Umgebung im Dateisystem angibt. (Eine virtuelle Umgebung enthält keine Kopie des Dolmetschers, nur einen Link dazu.)

Ein Vorteil bei der Verwendung einer virtuellen Umgebung besteht darin, dass die virtuelle Umgebung beim Entwickeln Ihres Projekts im Laufe der Zeit immer die genauen Abhängigkeiten Ihres Projekts widerspiegelt. Dieses Verhalten unterscheidet sich von einer freigegebenen globalen Umgebung, die eine beliebige Anzahl von Bibliotheken enthält, unabhängig davon, ob Sie sie in Ihrem Projekt verwenden oder nicht. Aus einer virtuellen Umgebung können Sie ganz einfach eine requirements.txt Datei erstellen, die verwendet wird, um Paketabhängigkeiten von anderen Entwicklungs- oder Produktionscomputern neu zu installieren. Weitere Informationen finden Sie unter Verwalten der erforderlichen Pakete mit requirements.txt.

Wenn Sie ein Projekt in Visual Studio öffnen, das eine Datei requirements.txt enthält, bietet Ihnen Visual Studio automatisch die Möglichkeit, die virtuelle Umgebung neu zu erstellen. Auf Computern, auf denen Visual Studio nicht installiert ist, können Sie den Befehl pip install -r requirements.txt verwenden, um die erforderlichen Pakete wiederherzustellen.

Da eine virtuelle Umgebung einen hartcodierten Pfad zum Basis-Python-Interpreter enthält und Sie die Umgebung mithilfe der Datei requirements.txt neu erstellen können, lassen Sie den Umgebungsunterordner in der Regel aus der Quellcodeverwaltung aus. Nachdem Sie Ihrem Projekt eine virtuelle Umgebung hinzugefügt haben, wird sie im Fenster Python Environments angezeigt. Sie können sie dann wie jede andere Umgebung aktivieren und ihre Pakete verwalten.

Erstellen einer virtuellen Umgebung

Sie können eine neue virtuelle Umgebung direkt in Visual Studio wie folgt erstellen:

  1. Starten Sie das Hinzufügen von Umgebung :

    • Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf den Knoten Python Umgebungen für Ihr Projekt, und wählen Sie Add Environment aus.
    • Oder wählen Sie auf der symbolleiste Python Add Environment aus dem Dropdownmenü Environment aus.

  2. Wählen Sie im Dialogfeld " Umgebung hinzufügen " die Registerkarte "Virtuelle Umgebung " aus:

    Screenshot der Registerkarte

  3. Konfigurieren Sie die erforderlichen Felder:

    Pflichtfeld Beschreibung
    Projekt Identifizieren Sie das Projekt, in dem die Umgebung erstellt werden soll.
    Name Geben Sie den Namen für die neue virtuelle Umgebung an.
    Basisdolmetscher Geben Sie den Basissprachendolmetscher für die virtuelle Umgebung an.
    Location Das System legt den Standardspeicherort für die virtuelle Umgebung fest. Um den Speicherort zu ändern, wählen Sie den Link " Virtuelle Umgebung ändern" aus, navigieren Sie zum Speicherort, und wählen Sie "Ordner auswählen" aus.

  4. Konfigurieren Sie alle gewünschten optionalen Felder:

    Optionales Feld Beschreibung
    Installieren von Paketen aus Datei Geben Sie den Pfad zu einer requirements.txt Datei an, um der virtuellen Umgebung Pakete hinzuzufügen. Geben Sie den Speicherort und den Namen der Datei ein, oder navigieren Sie (...) zum Speicherort, und wählen Sie die Datei aus.
    Als aktuelle Umgebung festlegen Aktivieren Sie die neue Umgebung im ausgewählten Projekt, nachdem die Umgebung erstellt wurde.
    Als Standardumgebung für neue Projekte festlegen Automatisches Festlegen und Aktivieren der Umgebung in allen neuen Projekten, die in Visual Studio erstellt wurden. Diese Einstellung ist auch über die Option Diese als Standardumgebung für neue Projekte festlegen im Fenster Python-Umgebungen verfügbar. Wenn Sie diese Option verwenden, platzieren Sie die virtuelle Umgebung an einem Ort außerhalb eines bestimmten Projekts.
    Anzeigen im Fenster "Python-Umgebungen" Geben Sie an, ob das Fenster Python Environments angezeigt werden soll, nachdem Sie die neue Umgebung erstellt haben.
    Diese Umgebung global verfügbar machen Geben Sie an, ob die virtuelle Umgebung auch als globale Umgebung fungieren soll. Wenn Sie diese Option verwenden, platzieren Sie die virtuelle Umgebung an einem Ort außerhalb eines bestimmten Projekts.

  5. Wählen Sie "Erstellen" aus, um die virtuelle Umgebung abzuschließen.

Visual Studio zeigt eine Statusanzeige an, während sie die Umgebung konfiguriert und alle erforderlichen Pakete herunterlädt.

Nach Abschluss des Vorgangs aktiviert Visual Studio die neue virtuelle Umgebung und fügt sie dem Knoten Python Environments in Projektmappen-Explorer hinzu. Die Umgebung ist auch im Fenster Python Environments für das enthaltende Projekt verfügbar.

Aktivieren einer Umgebung

Führen Sie die folgenden Schritte aus, um eine vorhandene Umgebung für ein Projekt zu aktivieren:

  1. Erweitern Sie in Projektmappen-Explorer den Knoten Python Environments für Ihr Projekt, und suchen Sie die Umgebung, die Sie verwenden möchten.

  2. Klicken Sie mit der rechten Maustaste auf die Umgebung, und wählen Sie "Umgebung aktivieren" aus.

    Wenn Visual Studio eine datei requirements.txt in dieser Umgebung erkennt, wird gefragt, ob diese Pakete installiert werden sollen.

    Nachdem Visual Studio die Umgebung aktiviert hat, wird der Name der aktiven Umgebung in einer fett formatierten Schriftart in Projektmappen-Explorer:

    Screenshot, der zeigt, wie Visual Studio den Namen der aktiven Umgebung im Projektmappen-Explorer in Fettdruck anzeigt.

    Screenshot, der zeigt, wie Visual Studio den Namen der aktiven Umgebung in fett formatierter Schriftart im Projektmappen-Explorer anzeigt.

Entfernen einer virtuellen Umgebung

Führen Sie die folgenden Schritte aus, um eine vorhandene Umgebung für ein Projekt zu entfernen:

  1. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf die virtuelle Umgebung, und wählen Sie Remove aus.

  2. Visual Studio fragt, ob Sie die virtuelle Umgebung entfernen oder löschen möchten.

    • Wählen Sie "Entfernen" aus, um die Umgebung für das Projekt nicht verfügbar zu machen, sie aber im Dateisystem zu belassen.
    • Wählen Sie "Löschen" aus, um die Umgebung aus dem Projekt zu entfernen und aus dem Dateisystem zu löschen. Der Basisdolmetscher ist nicht betroffen.

Anzeigen und Verwalten von installierten Paketen

In Projektmappen-Explorer können Sie die in einer Umgebung installierten Pakete anzeigen und verwalten. Diese Pakete können importiert und in Ihrem Code verwendet werden, wenn die Umgebung aktiv ist.

  • Um die in einer Umgebung installierten Pakete schnell anzuzeigen, erweitern Sie den Umgebungsknoten unter Python Environments Knoten für Ihr Projekt in Projektmappen-Explorer:

  • Wenn Sie neue Pakete installieren oder vorhandene Pakete verwalten möchten, klicken Sie mit der rechten Maustaste auf den Umgebungsknoten, und wählen Sie Manage Python Pakete aus. Sie können auch die Schaltfläche "Paket" auf der Symbolleiste Python verwenden:

    Das Fenster Python Umgebungen wird geöffnet und zeigt die installierten Pakete für die ausgewählte Umgebung auf der Registerkarte Packages (PyPI) an:

    In Visual Studio werden Pakete und Abhängigkeiten für die meisten Umgebungen aus dem Python Package Index (PyPI) heruntergeladen, in dem Sie auch nach verfügbaren Paketen suchen können. Visual Studio Statusleiste und Ausgabefenster zeigen Informationen zur Installation an.

  • Um ein Paket zu deinstallieren (entfernen), suchen Sie das Paket in der Liste, und wählen Sie das x-Symbol rechts aus.

  • Um nach aktualisierten Versionen eines Pakets oder anderer Pakete zu suchen, geben Sie einen Suchbegriff ein (in der Regel ein Paketname):

    Visual Studio zeigt übereinstimmende Pakete an. In diesem Beispiel erfolgt die Suche nach Paketen, die mit dem Begriff blinker übereinstimmen.

    Screenshot, der zeigt, wie Visual Studio die Suche nach passenden Paketen im Fenster 'Python-Umgebungen' ermöglicht.

    Visual Studio zeigt eine Liste der übereinstimmenden Ergebnisse als aktive Befehlslinks an.

    • Der erste Befehl aktualisiert das Paket auf die aktuellste Version und aktuelle Abhängigkeiten. Der Befehl ähnelt Run command: pip install <package-name>. Wenn Sie Enter nach dem Suchbegriff auswählen, führt Visual Studio diesen ersten Befehl automatisch aus.

    • Die anderen Links gelten für Befehle, die ein bestimmtes Paket, eine bestimmte Version oder Abhängigkeit installieren, z. B. Install blinker-async (0.0.3). Um einen dieser Befehle auszuführen, wählen Sie den Link aus.

Überlegungen zur Paketinstallation

Beachten Sie bei der Arbeit mit Paketen in Visual Studio die folgenden Überlegungen:

  • Beachten Sie, dass die angezeigten Einträge für Pakete in Bezug auf die neueste Version oder Verfügbarkeit möglicherweise nicht korrekt sind. Die für ein Paket angezeigten Installations- und Deinstallationsinformationen sind möglicherweise nicht zuverlässig oder verfügbar.

  • Visual Studio verwendet den Pip-Paket-Manager, falls verfügbar, und lädt ihn bei Bedarf herunter und installiert sie. Visual Studio können auch den easy_install Paket-Manager verwenden. Pakete, die mit den pipeasy_install Befehlen aus der Befehlszeile installiert werden, werden ebenfalls angezeigt.

  • Eine häufige Situation, in der pip ein Paket nicht installiert, besteht darin, dass das Paket Quellcode für systemeigene Komponenten in *.pyd-Dateien enthält. Ohne die erforderliche Version von Visual Studio installiert, kann Pip diese Komponenten nicht kompilieren. Die in dieser Situation angezeigte Fehlermeldung ist ein Fehler: vcvarsall.batkonnte nicht gefunden werden. Der Befehl easy_install ist häufig in der Lage, vorkompilierte Binärdateien herunterzuladen, und Sie können einen geeigneten Compiler für ältere Versionen von Python aus https://python.en.uptodown.com/windows/versions herunterladen. Weitere Informationen finden Sie im Python-Tools-Teamblog unter Wie man mit dem Problem "unable to find vcvarsallbat" umgeht.

  • Der Conda-Paket-Manager verwendet https://repo.continuum.io/pkgs/ im Allgemeinen als Standardkanal, aber andere Kanäle sind verfügbar. Weitere Informationen finden Sie unter Verwalten von Kanälen (docs.conda.io).

  • Visual Studio unterstützt derzeit die Verwendung des Befehls conda zum Installieren von Paketen in einer Conda-Umgebung nicht. Verwenden Sie stattdessen den conda Befehl über die Befehlszeile.

Verwandte Inhalte

  • Last updated on