Verwenden von Python-Ordnern in Visual Studio-Suchpfaden

  • Artikel

In einem typischen Python-Programm stellt die PYTHONPATH-Umgebungsvariable (oder IRONPYTHONPATH usw.) den Standardsuchpfad für Moduldateien bereit. Die Anweisungen from <name> import... oder import <name> weisen Python an, die spezifischen Speicherorte nach Dateien zu durchsuchen, die mit dem angegebenen <name> übereinstimmen. Die Speicherorte werden in der folgenden Reihenfolge durchsucht:

  1. Integrierte Python-Module
  2. Der Ordner, der den aktuell ausgeführten Python-Code enthält
  3. Der „Modulsuchpfad“ gemäß Definition durch die anwendbare Umgebungsvariable (Weitere Informationen finden Sie unter Der Modulsuchpfad und Umgebungsvariablen in der Kerndokumentation von Python.)

Visual Studio ignoriert die Suchpfad-Umgebungsvariable, selbst wenn die Variable für das gesamte System festgelegt ist. Der Grund dafür ist, dass die Verwendung der Variablen Fragen aufwirft, die nicht einfach beantwortet werden können, wie zum Beispiel:

  • Erwarten die referenzierten Module eine Installation von Python 2.7, Python 3.6 oder einer anderen Version?
  • Sollten Dateien, die in der Suchpfad-Umgebungsvariablen gefunden werden, Standardbibliotheksmodule überschreiben?
  • Wird ein Außerkraftsetzungsverhalten erwartet und behoben, oder könnte die Aktion böswillig sein?

Zur Unterstützung von Entwicklern bietet Visual Studio eine Möglichkeit, Suchpfade direkt in Python-Umgebungen und -Projekten anzugeben. Code, den Sie in Visual Studio ausführen oder debuggen, erhält Suchpfade von der PYTHONPATH-Umgebungsvariablen und der entsprechenden Variablen. Durch das Hinzufügen von Suchpfaden überprüft Visual Studio die Bibliotheken an den angegebenen Speicherorten und erstellt nach Bedarf IntelliSense-Datenbanken für die Bibliotheken. (In Visual Studio 2017, Version 15.5 und früher, kann das Erstellen der Datenbank je nach Anzahl der Bibliotheken einige Zeit in Anspruch nehmen).

Voraussetzungen

  • Visual Studio. Führen Sie zum Installieren des Produkts die Schritte unter Installieren von Visual Studio aus.

  • Python-Ordner, die Sie Ihren Suchpfaden hinzufügen möchten

Hinzufügen von Python-Ordnern zu Suchpfaden

Befolgen Sie diese Schritte, um einen Python-Ordner zu den Suchpfaden von Visual Studio hinzuzufügen:

  1. Erweitern Sie im Lösungsmappen-Explorer Ihren Python-Projektknoten, klicken Sie mit der rechten Maustaste auf Suchpfade, und wählen Sie Ordner zum Suchpfad hinzufügen aus:

    Screenshot, der zeigt, wie Sie den Befehl Ordner zum Suchpfad hinzufügen unter Suchpfade für ein Python-Projekt im Projektmappen-Explorer aufrufen.

  2. Navigieren Sie im Dialogfeld zum Speicherort des Ordners, den Sie zu den erkannten Suchpfaden hinzufügen möchten.

  3. Wählen Sie den Ordner und dann Ordner auswählen aus.

Nachdem Ordner zu den Suchpfaden hinzugefügt wurden, verwendet Visual Studio diese Pfade für jede Umgebung, die dem Projekt zugeordnet ist.

Hinweis

Wenn Ihre Umgebung auf Python 3 basiert und Sie versuchen, einen Suchpfad zu Python 2.7-Modulen hinzuzufügen, werden möglicherweise Fehler angezeigt.

Hinzufügen von ZIP- und EGG-Dateien zu Suchpfaden

Sie können Dateien mit einer .zip- oder .egg-Erweiterung verwenden, um Ihre Suchpfade mit der Option ZIP-Archiv zu Suchpfad hinzufügen zu suchen. Wie bei Ordnern wird der Inhalt dieser Dateien geprüft und IntelliSense zur Verfügung gestellt.

Zugehöriger Inhalt