Installieren von Debugsymbolen für Python-Dolmetscher in Visual Studio

Dieser Artikel enthält Schritte zum Herunterladen und Integrieren von Debuggingsymbolen für Python-Dolmetscher in Visual Studio.

Um ein vollständiges Debuggen zu ermöglichen, benötigt der Python-Debugger im gemischten Modus in Visual Studio Debugsymbole für den Python-Interpreter, um zahlreiche interne Datenstrukturen zu analysieren. Die Debugsymbole werden in Programmdatenbankdateien (PDB)-Dateien definiert. Beispielsweise erfordert die python27.dll-Bibliothek die Python27.pdb-Symboldatei , die python36.dll-Bibliothek verwendet die Symboldatei python36.pdb usw. Jede Version des Dolmetschers liefert auch Symboldateien für verschiedene Module.

• In Visual Studio 2017 und höher installieren die Python 3- und Anaconda 3-Dolmetscher automatisch ihre jeweiligen Symbole, und Visual Studio findet die Symbole automatisch.

• In Visual Studio 2015 und früher oder für andere Dolmetscher müssen Sie Symbole separat herunterladen und dann visual Studio auf die Dateien verweisen.

Wenn Visual Studio fehlende erforderliche Symbole erkennt, werden Sie in einem Dialogfeld aufgefordert, Maßnahmen zu ergreifen. Normalerweise wird das Dialogfeld angezeigt, wenn Sie eine Debugsitzung im gemischten Modus starten. Das Dialogfeld enthält zwei Links, von denen einer dieser Dokumentationsartikel geöffnet wird.

Das Dialogfeld "Symboleinstellungen öffnen" öffnet den Bereich ">" im Abschnitt "Alle Einstellungen>Debugging>Symbole".

Voraussetzungen

• Visual Studio mit Unterstützung für Python-Workloads installiert. Weitere Informationen finden Sie unter Installieren der Python-Unterstützung in Visual Studio.

Überprüfen Sie Ihre Interpreter-Version

Symbole unterscheiden sich zwischen Nebenbuilds von Python und 32-Bit- und 64-Bit-Builds. Es ist wichtig, Ihre Version und den Build von Python zu bestätigen, um sicherzustellen, dass Sie über die richtigen Symbole für Ihren Dolmetscher verfügen.

So überprüfen Sie, welcher Python-Dolmetscher verwendet wird:

1. Erweitern Sie im Projektmappen-Explorer den Knoten „Python-Umgebungen“ unter Ihrem Projekt.

2. Suchen Sie den Namen der aktuellen Umgebung (im Text fett dargestellt).

3. Klicken Sie mit der rechten Maustaste auf den Namen der Umgebung, und wählen Sie hier die Option "Eingabeaufforderung öffnen" aus.

   Ein Fenster der Eingabeaufforderung öffnet sich am Installationsspeicherort der aktuellen Umgebung.

4. Starten Sie Python, indem Sie den folgenden Befehl eingeben:

   python.exe
   

   Der Ausführungsprozess zeigt Ihre installierte Python-Version an und gibt an, ob es sich um 32-Bit- oder 64-Bit handelt:

   

Herunterladen von Symbolen

In den folgenden Schritten wird beschrieben, wie Sie die erforderlichen Symbole für einen Python-Dolmetscher herunterladen.

• Erwerben Sie für Python 3.5 und höher die Debugsymbole über das Python-Installationsprogramm.

  1. Wählen Sie "Benutzerdefinierte Installation" und dann "Weiter" aus.

  2. Wählen Sie auf der Seite "Erweiterte Optionen " die Felder für "Debugging-Symbole herunterladen " und "Debug-Binärdateien herunterladen" aus:

     

  Die Symboldateien (PDB) befinden sich im Stamminstallationsordner. Symboldateien für einzelne Module werden auch im Ordner "DLLs " abgelegt.

  Visual Studio findet diese Symbole automatisch. Es sind keine weiteren Schritte erforderlich.

• Für Python 3.4.x und frühere Versionen stehen Symbole als herunterladbare .zip Dateien aus den offiziellen Distributionen oder von Enthought Canopy zur Verfügung.

  1. Laden Sie die erforderliche Symboldatei herunter.

     Von Bedeutung

     Achten Sie darauf, die Symboldatei auszuwählen, die Ihrer installierten Python-Version und Ihrem Build entspricht (32-Bit oder 64-Bit).

  2. Extrahieren Sie die Symboldateien in einen lokalen Ordner im Python-Ordner, z. B. Symbole.

  3. Nachdem Sie die Dateien extrahiert haben, besteht der nächste Schritt darin, Visual Studio auf die Symbole zu verweisen.

• Wenden Sie sich für andere Python-Distributionen von Drittanbietern wie ActiveState Python an die Autoren dieser Verteilung, und fordern Sie sie an, Ihnen Symbole zur Verfügung zu stellen.

  WinPython integriert den Standard-Python-Dolmetscher ohne Änderungen. Sie können Symbole aus der offiziellen WinPython-Verteilung für die entsprechende Versionsnummer verwenden.

Richten Sie Visual Studio auf die Symbole aus.

Wenn Sie Symbole separat heruntergeladen haben, führen Sie die folgenden Schritte aus, um Visual Studio auf die Symbole aufmerksam zu machen.

Hinweis

Wenn Sie Symbole mithilfe des Python 3.5- oder höher-Installationsprogramms installiert haben, findet Visual Studio die Symbole automatisch. Sie müssen die Schritte in diesem Abschnitt nicht ausführen.

1. Öffnen Sie den Bereich "Extras">Optionen, und erweitern Sie den Abschnitt "Alle Einstellungen">Debugging>Symbols>Search Locations.

2. Wählen Sie auf der Symbolleiste für die Speicherortliste der Symboldatei (PDB)die Option +Hinzufügen aus.

3. Geben Sie im Dialogfeld " Element hinzufügen " den Ordnerpfad ein, in den Sie die heruntergeladenen Symbole extrahiert haben, und wählen Sie dann " Speichern" aus.

   Geben Sie den Speicherort an, an dem sich die Datei python.pdb befindet, z. B . "c:\python34\Symbols", wie in der folgenden Abbildung dargestellt.

   

Während einer Debugsitzung werden Sie möglicherweise auch von Visual Studio aufgefordert, den Speicherort einer Quelldatei für den Python-Interpreter einzugeben. Wenn Sie Quelldateien heruntergeladen haben, z. B. aus python.org/downloads/, können Sie Visual Studio auf die heruntergeladenen Dateien verweisen.

Optionen zum Zwischenspeichern von Symbolen

Der Abschnitt Alle Einstellungen>Debugging>Symbole unterstützt weitere Optionen zum Konfigurieren des Symbol-Cachings in den Unterabschnitten Suchspeicherorte und Suchen und Laden. Visual Studio verwendet die Features zum Zwischenspeichern von Symbolen, um einen lokalen Cache von Symbolen zu erstellen, die aus einer Onlinequelle abgerufen wurden.

Diese Features werden nicht mit den Python-Interpretersymbolen benötigt, da Symbole bereits lokal vorhanden sind. Weitere Informationen finden Sie unter Angeben von Symbolen und Quelldateien im Visual Studio-Debugger.

Zugriffsdownloads für offizielle Distributionen

In der folgenden Tabelle sind Downloadinformationen für offizielle Python-Versionsversionen aufgeführt.

Python-Version	Downloads
3.5 und höher	Installieren Sie Symbole über das Python-Installationsprogramm.
3.4.4	32-Bit - 64-Bit
3.4.3	32-Bit - 64-Bit
3.4.2	32-Bit - 64-Bit
3.4.1	32-Bit - 64-Bit
3.4.0	32-Bit - 64-Bit
3.3.5	32-Bit - 64-Bit
3.3.4	32-Bit - 64-Bit
3.3.3	32-Bit - 64-Bit
3.3.2	32-Bit - 64-Bit
3.3.1	32-Bit - 64-Bit
3.3.0	32-Bit - 64-Bit
2.7.18	32-Bit - 64-Bit
2.7.17	32-Bit - 64-Bit
2.7.16	32-Bit - 64-Bit
2.7.15	32-Bit - 64-Bit
2.7.14	32-Bit - 64-Bit
2.7.13	32-Bit - 64-Bit
2.7.12	32-Bit - 64-Bit
2.7.11	32-Bit - 64-Bit
2.7.10	32-Bit - 64-Bit
2.7.9	32-Bit - 64-Bit
2.7.8	32-Bit - 64-Bit
2.7.7	32-Bit - 64-Bit
2.7.6	32-Bit - 64-Bit
2.7.5	32-Bit - 64-Bit
2.7.4	32-Bit - 64-Bit
2.7.3	32-Bit - 64-Bit
2.7.2	32-Bit - 64-Bit
2.7.1	32-Bit - 64-Bit

Verwenden von Enthought Canopy-Symbolen

Enthought Canopy stellt Debugsymbole für die Binärdateien ab Version 1.2 bereit. Diese Symbole werden automatisch zusammen mit der Verteilung installiert.

• Um die Symbole zu verwenden, fügen Sie den Ordner, der die Symbole enthält, manuell dem Symbolpfad hinzu, wie in Visual Studio auf die Symbole verweisen beschrieben.

  Bei einer typischen Benutzerinstallation von Canopy befinden sich die Symbole in den folgenden Ordnern:

  • 64-Bit-Version: %UserProfile%\AppData\Local\Enthought\Canopy\User\Scripts
  • 32-Bit-Version: %UserProfile%\AppData\Local\Enthought\Canopy32\User\Scripts

Enthought Canopy 1.1 und frühere Versionen sowie die Enthought Python Distribution (EPD) bieten keine Interpretersymbole. Diese Versionen sind nicht mit dem Debuggen im gemischten Modus kompatibel.

Verwandte Inhalte

• Angeben von Symbolen und Quelldateien im Visual Studio-Debugger
• Debuggen von Python und C++ zusammen (Debuggen im gemischten Modus)