Installare i simboli di debug per gli interpreti Python in Visual Studio

Questo articolo illustra la procedura per scaricare e integrare i simboli di debug per gli interpreti Python in Visual Studio.

Per offrire un'esperienza di debug completa, il debugger Python in modalità mista in Visual Studio richiede simboli di debug per l'interprete Python per analizzare numerose strutture di dati interne. I simboli di debug sono definiti nei file di database di programma (con estensione pdb). Ad esempio, la libreria di python27.dll richiede il file di simboli python27.pdb , la libreria python36.dll usa il file di simboli python36.pdb e così via. Ogni versione dell'interprete fornisce anche i file di simboli per vari moduli.

• In Visual Studio 2017 e versioni successive, gli interpreti Python 3 e Anaconda 3 installano automaticamente i rispettivi simboli e Visual Studio trova automaticamente i simboli.

• In Visual Studio 2015 e versioni precedenti o per altri interpreti è necessario scaricare i simboli separatamente e quindi puntare Visual Studio ai file.

Quando Visual Studio rileva simboli obbligatori mancanti, viene visualizzata una finestra di dialogo che richiede di eseguire l'azione. In genere viene visualizzata la finestra di dialogo quando si avvia una sessione di debug in modalità mista. La finestra di dialogo include il collegamento Apri impostazioni simbolo, che apre la finestra di dialogo Opzioni strumenti>alla scheda Simboli di debug>, insieme a un collegamento a questo articolo della documentazione.

Prerequisiti

• Visual Studio installato con il supporto per i carichi di lavoro Python. Per altre informazioni, vedere Installare il supporto python in Visual Studio.

Controllare la versione dell'interprete

I simboli differiscono tra build secondarie di Python e tra build a 32 bit e a 64 bit. È importante confermare la versione e la compilazione di Python per assicurarsi di avere i simboli corretti per l'interprete.

Per verificare quale interprete Python è in uso:

1. In Esplora soluzioni espandere il nodo Ambienti Python nel progetto.

2. Individuare il nome dell'ambiente corrente (visualizzato in grassetto).

3. Fare clic con il pulsante destro del mouse sul nome dell'ambiente e scegliere Apri prompt dei comandi qui.

   Viene visualizzata una finestra del prompt dei comandi per il percorso di installazione dell'ambiente corrente.

4. Avviare Python immettendo il comando seguente:

   python.exe
   

   Il processo di esecuzione visualizza la versione di Python installata e indica se è a 32 bit o a 64 bit:

   

Scaricare i simboli

I passaggi seguenti descrivono come scaricare i simboli necessari per un interprete Python.

• Per Python 3.5 e versioni successive, acquisire i simboli di debug tramite il programma di installazione di Python.

  1. Selezionare Installazione personalizzata e quindi avanti.

  2. Nella pagina Opzioni avanzate selezionare le caselle Download debug symbols (Scarica simboli di debug) e Download debug binaries (Scarica file binari di debug):

     

  I file di simboli (con estensione pdb) si trovano nella cartella di installazione radice. I file di simboli per i singoli moduli vengono inseriti anche nella cartella DLL .

  Visual Studio trova automaticamente questi simboli. Non sono necessari altri passaggi.

• Per Python 3.4.x e versioni precedenti, i simboli sono disponibili come file scaricabili .zip dalle distribuzioni ufficiali o da Enthought Canopy.

  1. Scaricare il file di simboli richiesto.

     Importante

     Assicurarsi di selezionare il file di simboli corrispondente alla versione di Python installata e alla build (a 32 bit o a 64 bit).

  2. Estrarre i file di simboli in una cartella locale all'interno della cartella Python, ad esempio Simboli.

  3. Dopo aver estratto i file, il passaggio successivo consiste nel puntare Visual Studio ai simboli.

• Per altre distribuzioni Python di terze parti, ad esempio ActiveState Python, contattare gli autori di tale distribuzione e richiedere loro di fornire simboli.

  WinPython incorpora l'interprete Python standard senza modifiche. Puoi usare i simboli della distribuzione ufficiale di WinPython per il numero di versione corrispondente.

Impostare Visual Studio in modo che punti ai simboli

Se i simboli sono stati scaricati separatamente, seguire questa procedura per rendere Visual Studio consapevole dei simboli.

Nota

Se i simboli sono stati installati usando il programma di installazione di Python 3.5 o versione successiva, Visual Studio trova automaticamente i simboli. Non è necessario completare i passaggi descritti in questa sezione.

1. Selezionare Opzioni strumenti>e aprire la scheda Simboli di>debug.

2. Selezionare Aggiungi (simbolo più) sulla barra degli strumenti.

3. Immettere il percorso della cartella in cui sono stati estratti i simboli scaricati. Questo percorso è il percorso in cui si trova il python.pdb file, ad esempio c:\python34\Symbols, come illustrato nell'immagine seguente.

   

4. Seleziona OK.

Durante una sessione di debug Visual Studio potrebbero anche richiedere il percorso di un file di origine per l'interprete Python. Se sono stati scaricati file di origine, ad esempio da python.org/downloads/, è possibile puntare Visual Studio ai file scaricati.

Opzioni di memorizzazione nella cache dei simboli

La finestra di dialogo Strumenti>Opzioni, Debug>simboli contiene anche opzioni per configurare la memorizzazione nella cache dei simboli. Visual Studio usa le funzionalità di memorizzazione nella cache dei simboli per creare una cache locale di simboli ottenuti da un'origine online.

Queste funzionalità non sono necessarie con i simboli dell'interprete Python perché i simboli sono già presenti in locale. Per altre informazioni, vedere Specificare simboli e file di origine nel debugger di Visual Studio.

Accedere ai download per le distribuzioni ufficiali

La tabella seguente elenca le informazioni di download per le versioni ufficiali di Python.

Versione di Python	Download
3.5 e versioni successive	Installare i simboli usando il programma di installazione di Python.
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

Usare simboli Canopy enthought

Canopy enthought fornisce simboli di debug per i relativi file binari a partire dalla versione 1.2. Questi simboli vengono installati automaticamente insieme alla distribuzione.

• Per usare i simboli, aggiungere manualmente la cartella che contiene i simboli al percorso del simbolo, come descritto in Puntare Visual Studio ai simboli.

  Per un'installazione tipica per utente di Canopy, i simboli si trovano nelle cartelle seguenti:

  • Versione a 64 bit: %UserProfile%\AppData\Local\Enthought\Canopy\User\Scripts
  • Versione a 32 bit: %UserProfile%\AppData\Local\Enthought\Canopy32\User\Scripts

Enthought Canopy 1.1 e versioni precedenti e Enthought Python Distribution (EPD), non forniscono simboli interpreti. Queste versioni non sono compatibili con il debug in modalità mista.

Contenuto correlato

• Specificare simboli e file di origine nel debugger di Visual Studio
• Eseguire il debug di Python e C++ insieme (debug in modalità mista)