Instalar símbolos de depuração para interpretadores Python no Visual Studio

Este artigo fornece passos para descarregar e integrar símbolos de depuração para interpretadores Python no Visual Studio.

Para proporcionar uma experiência completa de depuração, o depurador Python de modo misto no Visual Studio precisa de símbolos de depuração para o interpretador Python analisar várias estruturas de dados internas. Os símbolos de depuração são definidos em ficheiros de base de dados de programas (.pdb). Por exemplo, a biblioteca python27.dll requer o ficheiro de símbolos python27.pdb , a bibliotecapython36.dll usa o ficheiro de símbolos python36.pdb, e assim sucessivamente. Cada versão do interpretador também fornece ficheiros de símbolos para vários módulos.

• No Visual Studio 2017 e posteriores, os interpretadores de Python 3 e Anaconda 3 instalam automaticamente os respetivos símbolos e o Visual Studio encontra os símbolos automaticamente.

• No Visual Studio 2015 e anteriores, ou noutros intérpretes, é necessário descarregar símbolos separadamente e depois apontar o Visual Studio para os ficheiros.

Quando o Visual Studio deteta símbolos obrigatórios em falta, um diálogo pede para que tome medidas. Normalmente vês o diálogo quando inicias uma sessão de depuração em modo misto. O diálogo inclui dois links, um dos quais abre este artigo de documentação.

O diálogo de definições de símbolos abre o painel de Ferramentas>Opções na secção Todas as Definições para Depuração>Símbolos.

Pré-requisitos

• Visual Studio instalado com suporte para cargas de trabalho em Python. Para obter mais informações, consulte Instalar suporte a Python no Visual Studio.

Verifica a versão do teu intérprete

Os símbolos diferem entre versões menores de Python e entre versões de 32 bits e 64 bits. É importante confirmar a tua versão e build do Python para garantir que tens os símbolos corretos para o teu intérprete.

Para verificar qual interpretador de Python está em uso:

1. No Explorador de Soluções, expanda o nóde Ambientes Python no seu projeto.

2. Localize o nome do ambiente atual (mostrado a negrito).

3. Clique com o botão direito no nome do ambiente e selecione Abrir Prompt de Comando Aqui.

   Uma janela de prompt de comandos abre no local de instalação do ambiente atual.

4. Comece Python introduzindo o seguinte comando:

   python.exe
   

   O processo de execução mostra a sua versão instalada em Python e indica se é de 32 bits ou de 64 bits:

   

Símbolos de download

Os passos seguintes descrevem como descarregar os símbolos necessários para um interpretador Python.

• Para Python 3.5 e posteriores, adquira os símbolos de depuração através do instalador Python.

  1. Selecione Instalação personalizada e depois selecione Próximo.

  2. Na página Opções Avançadas, selecione as caixas para Transferir símbolos de depuração e Transferir binários de depuração:

     

  Os ficheiros de símbolos (.pdb) estão localizados na pasta raiz de instalação. Ficheiros de símbolos para módulos individuais também são colocados na pasta DLLs .

  O Visual Studio encontra estes símbolos automaticamente. Não são necessários mais passos.

• Para Python 3.4.x e anteriores, os símbolos estão disponíveis como ficheiros descarregáveis .zip nas distribuições oficiais ou no Enthought Canopy.

  1. Descarregue o ficheiro de símbolos necessário.

     Importante

     Certifique-se de selecionar o ficheiro de símbolo que corresponde à sua versão e build instalada em Python (32 bits ou 64 bits).

  2. Extrai os ficheiros de símbolos para uma pasta local dentro da pasta Python, como Símbolos.

  3. Depois de extraíres os ficheiros, o passo seguinte é apontar o Visual Studio para os símbolos.

• Para outras distribuições Python de terceiros, como o ActiveState Python, contacte os autores dessa distribuição e peça que lhe forneçam símbolos.

  O WinPython incorpora o interpretador Python padrão sem alterações. Pode usar símbolos da distribuição oficial do WinPython para o número de versão correspondente.

Aponte o Visual Studio para os símbolos

Se descarregou símbolos separadamente, siga estes passos para tornar o Visual Studio ciente dos símbolos.

Observação

Se instalaste símbolos usando o instalador Python 3.5 ou posterior, o Visual Studio encontra os símbolos automaticamente. Não precisa de completar os passos desta secção.

1. Abra o painel Ferramentas>Opções e expanda as Todas as Definições>Secções>Depuração>Símbolos e Localizações de Pesquisa.

2. Na barra de ferramentas da lista de localizações do ficheiro Símbolo (.pdb ), selecione + Adicionar.

3. No diálogo Adicionar item , introduza o caminho da pasta onde extraiu os símbolos descarregados e depois selecione Guardar.

   Especifique o local onde o ficheiro python.pdb está localizado, como c:\python34\Symbols, como mostrado na imagem seguinte.

   

Durante uma sessão de depuração, o Visual Studio pode também pedir a localização de um ficheiro-fonte para o interpretador Python. Se descarregaste ficheiros fonte, como do python.org/downloads/, podes apontar o Visual Studio para os ficheiros descarregados.

Opções de cache de símbolos

A secção Todas as Definições>Depuração>Símbolos suporta outras opções para configurar a cache de símbolos nas subsecções Localizações de Pesquisa e Pesquisa e Carregamento. O Visual Studio utiliza as funcionalidades de cache de símbolos para criar uma cache local de símbolos obtidos de uma fonte online.

Estas funcionalidades não são necessárias com os símbolos do interpretador Python porque os símbolos já estão presentes localmente. Para mais informações, consulte Especificar símbolos e ficheiros fonte no depurador Visual Studio.

Aceda aos downloads para distribuições oficiais

A tabela seguinte lista informações para download das versões oficiais em Python.

Versão de Python	Downloads
3.5 e posteriores	Instala símbolos através do instalador Python.
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

Usar símbolos do Enthought Canopy

O Enthought Canopy fornece símbolos de depuração para os seus binários a partir da versão 1.2. Estes símbolos são automaticamente instalados juntamente com a distribuição.

• Para usar os símbolos, adicione manualmente a pasta que contém os símbolos ao caminho dos símbolos, conforme descrito em Apontar o Visual Studio para os símbolos.

  Para uma instalação típica do Canopy por utilizador, os símbolos encontram-se nas seguintes pastas:

  • Versão de 64 bits: %UserProfile%\AppData\Local\Enthought\Canopy\User\Scripts
  • Versão de 32 bits: %UserProfile%\AppData\Local\Enthought\Canopy32\User\Scripts

O Enthought Canopy 1.1 e anteriores e a Enthought Python Distribution (EPD) não fornecem símbolos interpretadores. Estas versões não são compatíveis com depuração em modo misto.

Conteúdo relacionado

• Especificar símbolos e ficheiros de origem no depurador Visual Studio
• Depurar Python e C++ juntos (depuração em modo misto)