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

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

Para fornecer uma experiência de depuração completa, o depurador python de modo misto no Visual Studio precisa de símbolos de depuração para que o interpretador do Python analise várias estruturas de dados internas. Os símbolos de depuração são definidos em arquivos de banco de dados do programa (.pdb). Por exemplo, a biblioteca depython27.dll requer o arquivo de símbolo python27.pdb , a biblioteca depython36.dll usa o arquivo de símbolo python36.pdb e assim por diante. Cada versão do interpretador também fornece arquivos de símbolo para vários módulos.

• No Visual Studio 2017 e posterior, os interpretadores do Python 3 e do Anaconda 3 instalam automaticamente seus respectivos símbolos e o Visual Studio localiza os símbolos automaticamente.

• No Visual Studio 2015 e versões anteriores, ou para outros interpretadores, você precisa baixar símbolos separadamente e, em seguida, apontar o Visual Studio para os arquivos.

Quando o Visual Studio detecta símbolos necessários ausentes, uma caixa de diálogo solicita que você execute uma ação. Normalmente, você vê a caixa de diálogo ao iniciar uma sessão de depuração em modo misto. A caixa de diálogo inclui dois links, um dos quais abre este artigo de documentação.

A caixa de diálogo Configurações de símbolo aberto abre o painel Ferramentas>Opções para a seção Todas as Configurações>Depuração>Símbolos.

Pré-requisitos

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

Verificar a versão do interpretador

Os símbolos diferem entre versões secundárias do Python e entre as versões de 32 bits e 64 bits. É importante confirmar sua versão e o build do Python para garantir que você tenha os símbolos corretos para o interpretador.

Para verificar qual interpretador do Python está em uso:

1. No Gerenciador de Soluções, expanda o nó de Ambientes do Python em seu projeto.

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

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

   Abre-se uma janela do prompt de comando para o local de instalação do ambiente atual.

4. Inicie o Python inserindo o seguinte comando:

   python.exe
   

   O processo de execução exibe sua versão do Python instalada e indica se ela tem 32 bits ou 64 bits:

   

Baixar símbolos

As etapas a seguir descrevem como baixar os símbolos necessários para um interpretador do Python.

• Para Python 3.5 e posterior, adquira os símbolos de depuração por meio do instalador do Python.

  1. Selecione Instalação personalizada e selecione Avançar.

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

     

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

  O Visual Studio localiza esses símbolos automaticamente. Nenhuma etapa adicional é necessária.

• Para Python 3.4.x e anteriores, os símbolos estão disponíveis como arquivos para download .zip das distribuições oficiais ou do Enthought Canopy.

  1. Baixe o arquivo de símbolo necessário.

     Importante

     Selecione o arquivo de símbolo que corresponde à versão e ao build do Python instalados (32 bits ou 64 bits).

  2. Extraia os arquivos de símbolo para uma pasta local dentro da pasta Python, como Símbolos.

  3. Depois de extrair os arquivos, a próxima etapa é apontar o Visual Studio para os símbolos.

• Para outras distribuições de Python de terceiros, como o ActiveState Python, entre em contato com os autores dessa distribuição e solicite que eles forneçam símbolos.

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

Configure o Visual Studio para apontar para os símbolos

Se você baixou símbolos separadamente, siga estas etapas para tornar o Visual Studio ciente dos símbolos.

Observação

Se você instalou símbolos usando o instalador Python 3.5 ou posterior, o Visual Studio localizará os símbolos automaticamente. Você não precisa concluir as etapas nesta seção.

1. Abra o painel Ferramentas>Opções e expanda a seção Todas as Configurações>Depuração>Símbolos>Locais de Pesquisa.

2. Na barra de ferramentas da lista de locais do arquivo de símbolo (.pdb), selecione + Adicionar.

3. Na caixa de diálogo Adicionar item , insira o caminho da pasta em que você extraiu os símbolos baixados e selecione Salvar.

   Especifique o local onde o arquivo python.pdb está localizado, como c:\python34\Symbols, conforme mostrado na imagem a seguir.

   

Durante uma sessão de depuração, o Visual Studio também pode solicitar a localização de um arquivo de origem para o interpretador do Python. Se você baixou arquivos de origem, como de python.org/downloads/, poderá apontar o Visual Studio para os arquivos baixados.

Opções de cache de símbolo

A seção Configurações>Depuração>Símbolos dá suporte a outras opções para configurar o cache de Símbolos nas subseções Locais de Pesquisa e Pesquisar e Carregar. O Visual Studio usa os recursos de cache de símbolos para criar um cache local de símbolos obtidos de uma fonte online.

Esses recursos não são necessários com os símbolos do interpretador do Python porque os símbolos já estão presentes localmente. Para obter mais informações, consulte Especificar símbolos e arquivos de origem no depurador do Visual Studio.

Acesse os downloads para distribuições oficiais

A tabela a seguir lista as informações de download para versões oficiais do Python.

Versão do Python	Downloads
3.5 e posterior	Instale símbolos por meio do instalador do 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 Enthought Canopy

O Enthought Canopy fornece símbolos de depuração para seus binários a partir da versão 1.2. Esses símbolos são instalados automaticamente junto 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 direcione o Visual Studio para os símbolos.

  Para uma instalação típica por usuário do Canopy, os símbolos estão localizados 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

Enthought Canopy 1.1 e anteriores e Distribuição Python da Enthought (EPD) não fornecem símbolos de interpretador. Essas releases não são compatíveis com a depuração em modo misto.

Conteúdo relacionado

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