Sdílet prostřednictvím


Instalace symbolů ladění pro interprety Pythonu v sadě Visual Studio

Tento článek obsahuje kroky ke stažení a integraci symbolů ladění pro interprety Pythonu v sadě Visual Studio.

Aby bylo možné poskytnout plnou debugovací zkušenost, ladicí program ve smíšeném režimu Pythonu v sadě Visual Studio potřebuje symboly ladění pro interpreta Pythonu k analýze mnoha interních datových struktur. Symboly ladění jsou definovány v souborech databáze programů (.pdb). Knihovna python27.dll například vyžaduje soubor symbolů python27.pdb , knihovnapython36.dll používá soubor symbolů python36.pdb atd. Každá verze interpreta také poskytuje soubory symbolů pro různé moduly.

  • Interpretéry Python 3 a Anaconda 3 v sadách Visual Studio 2017 a novějších automaticky instalují své příslušné symboly a Visual Studio tyto symboly automaticky najde.

  • V sadě Visual Studio 2015 a starších verzích nebo pro jiné interprety je potřeba stáhnout symboly samostatně a pak nasměrovat Visual Studio na soubory.

Když Visual Studio zjistí chybějící požadované symboly, zobrazí se dialogové okno s výzvou k provedení akce. Při spuštění relace ladění smíšeného režimu se obvykle zobrazí dialogové okno. Dialogové okno obsahuje dvě odkazy, z nichž jedna otevře tento článek dokumentace.

Snímek obrazovky znázorňující výzvu ve Visual Studiu pro zadání chybějících potřebných symbolů ladění

Dialog Otevřít nastavení symbolů otevře panel Nástroje>Možnosti na sekci Všechna nastavení>Ladění>Symboly.

Dialogové okno Nastavení symbolů otevře dialogové okno Možnosti nástrojů> a přejde do části Ladění Symboly>.

Požadavky

Zkontrolujte verzi interpreta

Symboly se liší mezi dílčími buildy Pythonu a mezi 32bitovými a 64bitovými buildy. Je důležité potvrdit svou verzi a sestavení Pythonu, abyste měli jistotu, že máte správné symboly interpretu.

Pokud chcete zkontrolovat, který interpret Pythonu se používá:

  1. V Průzkumníku řešení rozbalte uzelProstředí Pythonu pod projektem.

  2. Vyhledejte název aktuálního prostředí (zobrazený tučně).

  3. Klikněte pravým tlačítkem myši na název prostředí a vyberte Otevřít příkazový řádek zde.

    Otevře se okno příkazového řádku s umístěním instalace aktuálního prostředí.

  4. Spusťte Python zadáním následujícího příkazu:

    python.exe
    

    Proces provádění zobrazí nainstalovanou verzi Pythonu a označuje, jestli je 32bitová nebo 64bitová:

    Snímek obrazovky, který ukazuje, jak pomocí příkazového řádku otevřeného do umístění instalace aktuálního prostředí zjistit verzi Pythonu

Stažení symbolů

Následující kroky popisují, jak stáhnout požadované symboly pro interpret Pythonu.

  • Pro Python 3.5 a novější můžete získat symboly ladění prostřednictvím instalátoru Pythonu.

    1. Vyberte Vlastní instalace a pak vyberte Další.

    2. Na stránce Upřesnit možnosti vyberte políčka pro stažení symbolů ladění a stažení binárních souborů ladění:

      Snímek obrazovky znázorňující výběr symbolů ladění a binárních souborů v instalačním programu Pythonu 3.x

    Soubory symbolů (.pdb) jsou umístěny v kořenové instalační složce. Soubory symbolů pro jednotlivé moduly jsou také umístěny ve složce DLL .

    Visual Studio najde tyto symboly automaticky. Nejsou potřeba žádné další kroky.

  • Pro Python 3.4.x a starší jsou symboly k dispozici jako soubory ke stažení .zip z oficiálních distribucí nebo z Enthought Canopy.

    1. Stáhněte požadovaný soubor symbolů.

      Důležité

      Nezapomeňte vybrat soubor symbolů, který odpovídá nainstalované verzi Pythonu a sestavení (32bitová nebo 64bitová verze).

    2. Extrahujte soubory symbolů do místní složky ve složce Pythonu, například symboly.

    3. Po extrahování souborů je dalším krokem nasměrování sady Visual Studio na symboly.

  • V případě jiných distribucí Pythonu třetích stran, jako je ActiveState Python, kontaktujte autory této distribuce a požádejte je, aby vám poskytli symboly.

    WinPython zahrnuje standardní interpret Pythonu beze změn. Pro odpovídající číslo verze můžete použít symboly z oficiální distribuce WinPythonu.

Nasměrujte Visual Studio na symboly

Pokud jste symboly stáhli samostatně, postupujte podle těchto kroků, abyste zkonfigurovali Visual Studio tak, aby symboly rozpoznalo.

Poznámka:

Pokud jste symboly nainstalovali pomocí instalačního programu Pythonu 3.5 nebo novějšího, Visual Studio vyhledá symboly automaticky. Nemusíte provádět kroky v této části.

  1. Otevřete podokno Nástroje>Možnosti a rozbalte sekci Všechna nastavení>Ladění>Symboly>Umístění hledání.

  2. V panelu nástrojů pro seznam umístění souborů symbolů (.pdb) vyberte možnost + Přidat.

  3. V dialogovém okně Přidat položku zadejte cestu ke složce, kam jste extrahovali stažené symboly, a pak vyberte Uložit.

    Zadejte umístění, kde se nachází soubor python.pdb , například c:\python34\Symbols, jak je znázorněno na následujícím obrázku.

    Snímek obrazovky znázorňující, jak určit umístění symbolů ladicího programu smíšeného režimu Pythonu

  1. Otevřete dialogové oknoNástroje>Možnosti a rozbalte částLadění>.

  2. Na panelu nástrojů pro seznam umístění hledání v souboru symbolů (.pdb) vyberte Přidat (symbol plus).

  3. V seznamu zadejte cestu ke složce, kam jste extrahovali stažené symboly, a pak vyberte OK.

    Zadejte umístění, kde se nachází soubor python.pdb , například c:\python34\Symbols, jak je znázorněno na následujícím obrázku.

    Snímek obrazovky znázorňující možnosti symbolů debuggeru ve smíšeném režimu v dialogu Možnosti nástrojů v sekci Ladění.

Během ladicí relace vás Visual Studio může také vyzvat k zadání umístění zdrojového souboru pro interpret Pythonu. Pokud jste stáhli zdrojové soubory, například z python.org/downloads/, můžete visual Studio nasměrovat na stažené soubory.

Možnosti ukládání symbolů do mezipaměti

Část Všechna Nastavení> ladění>Symboly podporuje další možnosti konfigurace ukládání symbolů do mezipaměti v pododdílech Místa hledání a Hledání a načítání. Visual Studio používá funkce ukládání symbolů do mezipaměti k vytvoření místní mezipaměti symbolů získaných z online zdroje.

> ČástLadění symbolů podporuje další možnosti konfigurace ukládání symbolů do mezipaměti. Visual Studio používá funkce ukládání symbolů do mezipaměti k vytvoření místní mezipaměti symbolů získaných z online zdroje.

Tyto funkce nejsou u symbolů interpretu Pythonu potřeba, protože symboly jsou už místně k dispozici. Další informace naleznete v tématu Zadání symbolů a zdrojových souborů v ladicím programu sady Visual Studio.

Přístup ke stažení pro oficiální distribuce

Následující tabulka uvádí informace o stažení pro oficiální verze Pythonu.

Verze Pythonu Downloads
3.5 a novější Nainstalujte symboly prostřednictvím instalačního programu Pythonu.
3.4.4 32bitová verze - 64bitová verze
3.4.3 32bitová verze - 64bitová verze
3.4.2 32bitová verze - 64bitová verze
3.4.1 32bitová verze - 64bitová verze
3.4.0 32bitová verze - 64bitová verze
3.3.5 32bitová verze - 64bitová verze
3.3.4 32bitová verze - 64bitová verze
3.3.3 32bitová verze - 64bitová verze
3.3.2 32bitová verze - 64bitová verze
3.3.1 32bitová verze - 64bitová verze
3.3.0 32bitová verze - 64bitová verze
2.7.18 32bitová verze - 64bitová verze
2.7.17 32bitová verze - 64bitová verze
2.7.16 32bitová verze - 64bitová verze
2.7.15 32bitová verze - 64bitová verze
2.7.14 32bitová verze - 64bitová verze
2.7.13 32bitová verze - 64bitová verze
2.7.12 32bitová verze - 64bitová verze
2.7.11 32bitová verze - 64bitová verze
2.7.10 32bitová verze - 64bitová verze
2.7.9 32bitová verze - 64bitová verze
2.7.8 32bitová verze - 64bitová verze
2.7.7 32bitová verze - 64bitová verze
2.7.6 32bitová verze - 64bitová verze
2.7.5 32bitová verze - 64bitová verze
2.7.4 32bitová verze - 64bitová verze
2.7.3 32bitová verze - 64bitová verze
2.7.2 32bitová verze - 64bitová verze
2.7.1 32bitová verze - 64bitová verze

Použití symbolů Enthought Canopy

Enthought Canopy poskytuje ladicí symboly pro své binární soubory od verze 1.2. Tyto symboly se společně s distribucí instalují automaticky.

  • Pokud chcete použít symboly, přidejte ručně složku obsahující symboly do cesty symbolů, jak je popsáno v Nasměrování Visual Studia na symboly.

    Pro typickou instalaci canopy pro jednotlivé uživatele jsou symboly umístěny v následujících složkách:

    • 64bitová verze: %UserProfile%\AppData\Local\Enthought\Canopy\User\Scripts
    • 32bitová verze: %UserProfile%\AppData\Local\Enthought\Canopy32\User\Scripts

Enthought Canopy 1.1 a starší a Enthought Python Distribution (EPD) neposkytuje symboly interpreta. Tyto verze nejsou kompatibilní s laděním ve smíšeném režimu.