Symbolen voor foutopsporing installeren voor Python-interpreters in Visual Studio

Dit artikel bevat stappen voor het downloaden en integreren van foutopsporingssymbolen voor Python-interpreters in Visual Studio.

Om een volledige foutopsporingservaring te bieden, heeft het Python-foutopsporingsprogramma in de gemengde modus in Visual Studio foutopsporingssymbolen nodig voor de Python-interpreter om talloze interne gegevensstructuren te parseren. De symbolen voor foutopsporing worden gedefinieerd in programmadatabasebestanden (.pdb). De python27.dll-bibliotheek vereist bijvoorbeeld het python27.pdb-symboolbestand , de python36.dll-bibliotheek maakt gebruik van het symboolbestand python36.pdb, enzovoort. Elke versie van de interpreter levert ook symboolbestanden voor verschillende modules.

• In Visual Studio 2017 en hoger installeren de Python 3- en Anaconda 3-interpreters automatisch hun respectieve symbolen en vindt Visual Studio de symbolen automatisch.

• In Visual Studio 2015 en eerder, of voor andere interpreters, moet u symbolen afzonderlijk downloaden en Visual Studio vervolgens naar de bestanden laten verwijzen.

Wanneer Visual Studio ontbrekende vereiste symbolen detecteert, wordt u gevraagd actie te ondernemen. Normaal gesproken ziet u het dialoogvenster wanneer u een foutopsporingssessie in gemengde modus start. Het dialoogvenster bevat twee koppelingen, waarmee dit documentatieartikel wordt geopend.

In het dialoogvenster Symboolinstellingen wordt het deelvenster Extra>Opties geopend naar de sectie Alle instellingen>Foutopsporing>Symbolen.

Vereiste voorwaarden

• Visual Studio geïnstalleerd met ondersteuning voor Python-workloads. Zie Python-ondersteuning installeren in Visual Studiovoor meer informatie.

De interpreterversie controleren

Symbolen verschillen tussen versies van Python en tussen 32-bits en 64-bits configuraties. Het is belangrijk om uw versie en build van Python te bevestigen om ervoor te zorgen dat u de juiste symbolen voor uw interpreter hebt.

Controleren welke Python-interpreter wordt gebruikt:

1. Vouw in Solution Explorer het knooppuntPython-omgevingen onder uw project uit.

2. Zoek de naam van de huidige omgeving (vetgedrukt).

3. Klik met de rechtermuisknop op de naam van de omgeving en selecteer Hier opdrachtprompt openen.

   Er wordt een opdrachtpromptvenster geopend op de installatielocatie van de huidige omgeving.

4. Start Python door de volgende opdracht in te voeren:

   python.exe
   

   In het uitvoeringsproces wordt uw geïnstalleerde Python-versie weergegeven en wordt aangegeven of het 32-bits of 64-bits is:

   

Symbolen downloaden

In de volgende stappen wordt beschreven hoe u de vereiste symbolen voor een Python-interpreter downloadt.

• Voor Python 3.5 en hoger verkrijgt u de foutopsporingssymbolen via het Python-installatieprogramma.

  1. Selecteer Aangepaste installatie en klik dan op Volgende.

  2. Selecteer op de pagina Geavanceerde opties de selectievakjes voor foutopsporingssymbolen downloaden en binaire bestanden voor foutopsporing downloaden:

     

  De symboolbestanden (.pdb) bevinden zich in de hoofdinstallatiemap. Symboolbestanden voor afzonderlijke modules worden ook in de map DLL's geplaatst.

  Visual Studio vindt deze symbolen automatisch. Er zijn geen verdere stappen nodig.

• Voor Python 3.4.x en eerder zijn symbolen beschikbaar als downloadbare .zip bestanden van de officiële distributies of van Enthought Luifel.

  1. Download het vereiste symboolbestand.

     Belangrijk

     Zorg ervoor dat u het symboolbestand selecteert dat overeenkomt met uw geïnstalleerde Python-versie en -build (32-bits of 64-bits).

  2. Pak de symboolbestanden uit naar een lokale map in de Python-map, zoals Symbolen.

  3. Nadat u de bestanden hebt geëxtraheerd, is de volgende stap het aanwijzen van Visual Studio naar de symbolen.

• Neem voor andere Python-distributies van derden, zoals ActiveState Python, contact op met de auteurs van die distributie en vraag hen om u symbolen te bieden.

  WinPython bevat de standaard Python-interpreter zonder wijzigingen. U kunt symbolen uit de officiële WinPython-distributie gebruiken voor het bijbehorende versienummer.

Wijs Visual Studio aan de symbolen

Als u symbolen afzonderlijk hebt gedownload, volgt u deze stappen om Visual Studio bewust te maken van de symbolen.

Opmerking

Als u symbolen hebt geïnstalleerd met behulp van het installatieprogramma voor Python 3.5 of hoger, worden de symbolen automatisch gevonden in Visual Studio. U hoeft de stappen in deze sectie niet te voltooien.

1. Open het deelvenster Extra>Opties en vouw de Alle instellingen>Debuggen>Symbolen>Zoeklocaties uit.

2. Selecteer + Toevoegen op de werkbalk voor de lijst met locaties van het symboolbestand (.pdb).

3. Voer in het dialoogvenster Item toevoegen het mappad in waarin u de gedownloade symbolen hebt uitgepakt en selecteer Opslaan.

   Geef de locatie op waar het bestand python.pdb zich bevindt, zoals c:\python34\Symbols, zoals wordt weergegeven in de volgende afbeelding.

   

Tijdens een foutopsporingssessie kan Visual Studio u ook vragen om de locatie van een bronbestand voor de Python-interpreter. Als u bronbestanden hebt gedownload, zoals van python.org/downloads/, kunt u Visual Studio naar de gedownloade bestanden laten verwijzen.

Opties voor het opslaan van symbolen in cache

De sectie Alle instellingen>Foutopsporingssymbolen> ondersteunt andere opties voor het configureren van symboolcaching in de subsecties Zoeken en Zoeken en Laden. Visual Studio maakt gebruik van de functies voor het opslaan van symbolen in cache om een lokale cache van symbolen te maken die zijn verkregen uit een onlinebron.

Deze functies zijn niet nodig met de Python-interpretersymbolen, omdat symbolen al lokaal aanwezig zijn. Zie Symbolen en bronbestanden opgeven in het foutopsporingsprogramma van Visual Studio voor meer informatie.

Toegangsdownloads voor officiële distributies

De volgende tabel bevat downloadgegevens voor officiële versies van Python-versies.

Python-versie	Downloads
3.5 en hoger	Installeer symbolen via het Python-installatieprogramma.
3.4.4	32-bits - 64-bits
3.4.3	32-bits - 64-bits
3.4.2	32-bits - 64-bits
3.4.1	32-bits - 64-bits
3.4.0	32-bits - 64-bits
3.3.5	32-bits - 64-bits
3.3.4	32-bits - 64-bits
3.3.3	32-bits - 64-bits
3.3.2	32-bits - 64-bits
3.3.1	32-bits - 64-bits
3.3.0	32-bits - 64-bits
2.7.18	32-bits - 64-bits
2.7.17	32-bits - 64-bits
2.7.16	32-bits - 64-bits
2.7.15	32-bits - 64-bits
2.7.14	32-bits - 64-bits
2.7.13	32-bits - 64-bits
2.7.12	32-bits - 64-bits
2.7.11	32-bits - 64-bits
2.7.10	32-bits - 64-bits
2.7.9	32-bits - 64-bits
2.7.8	32-bits - 64-bits
2.7.7	32-bits - 64-bits
2.7.6	32-bits - 64-bits
2.7.5	32-bits - 64-bits
2.7.4	32-bits - 64-bits
2.7.3	32-bits - 64-bits
2.7.2	32-bits - 64-bits
2.7.1	32-bits - 64-bits

Enthought luifelsymbolen gebruiken

Enthought Canopy biedt symbolen voor foutopsporing voor zijn binaries vanaf versie 1.2. Deze symbolen worden automatisch naast de distributie geïnstalleerd.

• Als u de symbolen wilt gebruiken, voegt u handmatig de map met de symbolen toe aan het pad naar het symbool, zoals beschreven in Point Visual Studio aan de symbolen.

  Voor een typische installatie per gebruiker van Luifel bevinden de symbolen zich in de volgende mappen:

  • 64-bit versie: %UserProfile%\AppData\Local\Enthought\Canopy\User\Scripts
  • 32-bits versie: %UserProfile%\AppData\Local\Enthought\Canopy32\User\Scripts

Enthought Luifel 1.1 en eerder en Enthought Python Distribution (EPD), bieden geen interpretersymbolen. Deze releases zijn niet compatibel met foutopsporing in de gemengde modus.

Verwante inhoud

• Symbolen en bronbestanden opgeven in het Visual Studio-foutopsporingsprogramma
• Python en C++ samen debuggen (gemengde-modus-debugging)