Partilhar via


Perfil de código Python no Visual Studio

Visual Studio fornece funcionalidades de perfilagem para aplicações Python quando se depura o código. O Visual Studio Depurador permite que você percorra seu código para verificar variáveis, analisar o estado do programa, resolver possíveis problemas e assim por diante. Os recursos de criação de perfil do Visual Studio fornecem informações sobre os tempos de execução do seu programa. Você pode usar essas informações para ajudar a identificar problemas de desempenho em seu código.

A criação de perfil está disponível para Python 3.9 e versões anteriores quando você usa um interpretador baseado em CPython.

Pré-requisitos

O Visual Studio para Mac não é suportado. Para obter mais informações, consulte O que está acontecendo com o Visual Studio para Mac? Visual Studio Code no Windows, Mac e Linux funciona bem com Python por meio de extensões disponíveis.

Usar a ferramenta de perfil com o interpretador baseado em CPython

Quando você cria o perfil de um aplicativo Python, o Visual Studio coleta dados para o tempo de vida do processo, medidos em milissegundos (ms).

Siga estas etapas para começar a trabalhar com os recursos de criação de perfil no Visual Studio:

  1. No Visual Studio, abra o arquivo de código Python.

  2. Confirme se o ambiente atual para seu código Python é um interpretador baseado em CPython. Você pode verificar o interpretador selecionado na janela Python Environments.

  3. Na barra de ferramentas principal, selecione >Iniciar Perfilagem do Python. O Visual Studio abre a caixa de diálogo Configurações de criação de perfil :

    Captura de tela da caixa de diálogo de configuração de perfis no Visual Studio.

  4. Na caixa de diálogo Configurações de criação de perfil, escolha o arquivo de código ou o código do projeto que você deseja perfilar:

    • Para analisar todo o código do projeto:

      1. Selecione Abrir projeto.

      2. Selecione o projeto na lista suspensa. A lista mostra todos os projetos na solução atual do Visual Studio.

    • Para criar o perfil de um arquivo específico:

      1. Selecione script autónomo.

      2. Selecione o Interpretador Python na lista suspensa ou navegue até ao local. Para especificar um intérprete não listado, selecione Outros na lista suspensa e especifique de seguida o Caminho do Intérprete.

      3. Identifique o Script arquivo ou navegue até o local.

      4. Especifique o Diretório de Trabalho ou navegue até o local.

      5. Especifique quaisquer argumentos de linha de comando para o script.

  5. Selecione Iniciar.

O perfilador é executado e abre um relatório de desempenho no Visual Studio. Você pode revisar o relatório para explorar como o tempo é gasto em seu aplicativo:

Captura de ecrã do relatório de desempenho de profiling no Visual Studio 2022.

Captura de tela do relatório de desempenho de perfil no Visual Studio.

Use o criador de perfis com o IronPython

IronPython é uma implementação .NET do Python que está disponível em versões de 32 bits e 64 bits. O IronPython não é um interpretador baseado em CPython. O Visual Studio oferece suporte à depuração Python padrão para IronPython, mas não aos recursos de criação de perfil.

Para projetos IronPython, você pode usar o criador de perfil do Visual Studio .NET. Execute o comando ipy.exe diretamente como o aplicativo de destino com os argumentos apropriados para iniciar o script de inicialização. Na linha de comando, inclua o argumento -X:Debug para garantir que todo o seu código Python possa ser depurado e perfilado. Esse argumento gera um relatório de desempenho que inclui o tempo gasto no tempo de execução do IronPython e seu código. Seu código é identificado usando nomes distorcidos.

O IronPython oferece alguns perfis integrados, mas atualmente não há um visualizador viável. Para obter mais informações, consulte An IronPython Profiler (blog) e Debugging and Profiling na documentação do IronPython.