Instalowanie symboli debugowania dla interpreterów języka Python w programie Visual Studio

Ten artykuł zawiera kroki pobierania i integrowania symboli debugowania dla interpreterów języka Python w programie Visual Studio.

Aby zapewnić pełne środowisko debugowania, debuger języka Python w trybie mieszanym w programie Visual Studio wymaga symboli debugowania dla interpretera języka Python, aby przeanalizować wiele wewnętrznych struktur danych. Symbole debugowania są definiowane w plikach bazy danych programu (.pdb). Na przykład biblioteka python27.dll wymaga pliku symboli python27.pdb , biblioteka python36.dll używa pliku symboli python36.pdb itd. Każda wersja interpretera dostarcza również pliki symboli dla różnych modułów.

• W programie Visual Studio 2017 i nowszych interpretery języka Python 3 i Anaconda 3 automatycznie instalują odpowiednie symbole, a program Visual Studio automatycznie odnajduje symbole.

• W programie Visual Studio 2015 lub starszym, lub w przypadku innych interpreterów, należy pobrać symbole każdy z osobna, a następnie wskazać programowi Visual Studio pliki.

Gdy program Visual Studio wykryje brakujące wymagane symbole, zostanie wyświetlone okno dialogowe z monitem o podjęcie akcji. Zazwyczaj jest wyświetlane okno dialogowe podczas uruchamiania sesji debugowania w trybie mieszanym. Okno dialogowe zawiera dwa linki, z których jeden otwiera ten artykuł dokumentacji.

Okno dialogowe Ustawienia symboli otwiera panel Narzędzia>Opcje w sekcji Wszystkie ustawienia>Debugowanie>Symbole.

Wymagania wstępne

• Program Visual Studio zainstalowany z obsługą obciążeń języka Python. Aby uzyskać więcej informacji, zobacz Instalowanie obsługi języka Python w programie Visual Studio.

Sprawdzanie wersji interpretera

Symbole różnią się między pomocniczymi kompilacjami języka Python i między kompilacjami 32-bitowymi i 64-bitowymi. Ważne jest, aby potwierdzić wersję i kompilację języka Python, aby upewnić się, że masz poprawne symbole interpretera.

Aby sprawdzić, który interpreter języka Python jest używany:

1. W Eksploratorze rozwiązań rozwiń węzełŚrodowiska języka Python w projekcie.

2. Znajdź nazwę bieżącego środowiska (pokazaną pogrubioną czcionką).

3. Kliknij prawym przyciskiem myszy nazwę środowiska i wybierz polecenie Otwórz wiersz polecenia tutaj.

   Zostanie otwarte okno wiersza polecenia w lokalizacji instalacji bieżącego środowiska.

4. Uruchom język Python, wprowadzając następujące polecenie:

   python.exe
   

   Proces wykonywania wyświetla zainstalowaną wersję języka Python i wskazuje, czy jest to 32-bitowa, czy 64-bitowa:

   

Pobierz symbole

W poniższych krokach opisano sposób pobierania wymaganych symboli interpretera języka Python.

• W przypadku języka Python w wersji 3.5 lub nowszej uzyskaj symbole debugowania za pośrednictwem instalatora języka Python.

  1. Wybierz pozycję Instalacja niestandardowa, a następnie wybierz pozycję Dalej.

  2. Na stronie Opcje zaawansowane zaznacz pola wyboru Pobierz symbole debugowania i Pobierz pliki binarne debugowania:

     

  Pliki symboli (.pdb) znajdują się w folderze instalacji głównej. Pliki symboli dla poszczególnych modułów są również umieszczane w folderze DLL.

  Program Visual Studio automatycznie odnajduje te symbole. Nie są potrzebne żadne dalsze kroki.

• W przypadku języka Python w wersji 3.4.x i starszych symbole są dostępne jako pliki do .zip pobrania z oficjalnych dystrybucji lub z Enthought Canopy.

  1. Pobierz wymagany plik symboli.

     Ważne

     Pamiętaj, aby wybrać plik symboli odpowiadający zainstalowanej wersji języka Python i kompilacji (32-bitowej lub 64-bitowej).

  2. Wyodrębnij pliki symboli do folderu lokalnego w folderze języka Python, na przykład Symbole.

  3. Po wyodrębnieniu plików następnym krokiem jest wskazanie programu Visual Studio symbolom.

• W przypadku innych dystrybucji języka Python innych firm, takich jak ActiveState Python, skontaktuj się z autorami tej dystrybucji i poproś o podanie symboli.

  Środowisko WinPython zawiera standardowy interpreter języka Python bez zmian. Możesz użyć symboli z oficjalnej dystrybucji WinPython dla odpowiedniego numeru wersji.

Skieruj Visual Studio na symbole

Jeśli symbole zostały pobrane oddzielnie, wykonaj następujące kroki, aby program Visual Studio wiedział o symbolach.

Uwaga / Notatka

Jeśli symbole zostały zainstalowane przy użyciu instalatora języka Python 3.5 lub nowszego, program Visual Studio automatycznie znajdzie symbole. Nie musisz wykonywać kroków opisanych w tej sekcji.

1. Otwórz panel Narzędzia>Opcje i rozwiń sekcję Wszystkie ustawienia>Debugowanie>Symbole>Lokalizacje wyszukiwania.

2. Na pasku narzędzi listy lokalizacje pliku symboli (.pdb) kliknij + Dodaj.

3. W oknie dialogowym Dodawanie elementu wprowadź ścieżkę folderu, w której wyodrębniono pobrane symbole, a następnie wybierz pozycję Zapisz.

   Określ lokalizację, w której znajduje się plik python.pdb , taki jak c:\python34\Symbols, jak pokazano na poniższej ilustracji.

   

Podczas sesji debugowania program Visual Studio może również wyświetlić monit o lokalizację pliku źródłowego interpretera języka Python. Jeśli pobrałeś pliki źródłowe, takie jak te z python.org/downloads/, możesz wskazać Visual Studio pobrane pliki.

Opcje buforowania symboli

Sekcja Wszystkie ustawienia>Debugowanie>symboli obsługuje inne opcje konfigurowania buforowania symboli w podsekcjach Wyszukiwanie lokalizacji i Wyszukiwanie i ładowanie. Program Visual Studio używa funkcji buforowania symboli do tworzenia lokalnej pamięci podręcznej symboli uzyskanych ze źródła online.

Te funkcje nie są potrzebne z symbolami interpretera języka Python, ponieważ symbole są już obecne lokalnie. Aby uzyskać więcej informacji, zobacz Określanie symboli i plików źródłowych w debugerze programu Visual Studio.

Dostęp do pobierania oficjalnych dystrybucji

W poniższej tabeli wymieniono informacje dotyczące pobierania oficjalnych wersji języka Python.

Wersja języka Python	Downloads
3.5 i nowsze	Zainstaluj symbole za pośrednictwem instalatora języka Python.
3.4.4	32-bitowy - 64-bitowy
3.4.3	32-bitowy - 64-bitowy
3.4.2	32-bitowy - 64-bitowy
3.4.1	32-bitowy - 64-bitowy
3.4.0	32-bitowy - 64-bitowy
3.3.5	32-bitowy - 64-bitowy
3.3.4	32-bitowy - 64-bitowy
3.3.3	32-bitowy - 64-bitowy
3.3.2	32-bitowy - 64-bitowy
3.3.1	32-bitowy - 64-bitowy
3.3.0	32-bitowy - 64-bitowy
2.7.18	32-bitowy - 64-bitowy
2.7.17	32-bitowy - 64-bitowy
2.7.16	32-bitowy - 64-bitowy
2.7.15	32-bitowy - 64-bitowy
2.7.14	32-bitowy - 64-bitowy
2.7.13	32-bitowy - 64-bitowy
2.7.12	32-bitowy - 64-bitowy
2.7.11	32-bitowy - 64-bitowy
2.7.10	32-bitowy - 64-bitowy
2.7.9	32-bitowy - 64-bitowy
2.7.8	32-bitowy - 64-bitowy
2.7.7	32-bitowy - 64-bitowy
2.7.6	32-bitowy - 64-bitowy
2.7.5	32-bitowy - 64-bitowy
2.7.4	32-bitowy - 64-bitowy
2.7.3	32-bitowy - 64-bitowy
2.7.2	32-bitowy - 64-bitowy
2.7.1	32-bitowy - 64-bitowy

Używanie symboli Enthought Canopy

Enthought Canopy zapewnia symbole debugowania dla swoich plików binarnych począwszy od wersji 1.2. Te symbole są instalowane automatycznie wraz z dystrybucją.

• Aby użyć symboli, ręcznie dodaj folder zawierający symbole do ścieżki symboli, zgodnie z opisem w temacie Point Visual Studio to the symbole.

  W przypadku typowej instalacji programu Canopy dla poszczególnych użytkowników symbole znajdują się w następujących folderach:

  • Wersja 64-bitowa: %UserProfile%\AppData\Local\Enthought\Canopy\User\Scripts
  • Wersja 32-bitowa: %UserProfile%\AppData\Local\Enthought\Canopy32\User\Scripts

Enthought Canopy 1.1 i wcześniejsze, oraz Enthought Python Distribution (EPD), nie zapewniają symboli interpretera. Te wersje nie są zgodne z debugowaniem w trybie mieszanym.

Treści powiązane

• Określanie symboli i plików źródłowych w debugerze programu Visual Studio
• Debugowanie języka Python i języka C++ razem (debugowanie w trybie mieszanym)