Início Rápido: abrir e executar o código do Python em uma pasta no Visual Studio

  • Artigo

Neste guia de início rápido, você segue as etapas guiadas para executar o código do Python no Visual Studio 2019 e posterior sem precisar criar um projeto do Visual Studio. O Visual Studio facilita a abertura e a execução do código do Python existente a partir de uma pasta. Os mesmos recursos e comandos estão disponíveis para o desenvolvimento do código do Python, como quando você escolhe trabalhar com um projeto.

Pré-requisitos

  • Ter o Visual Studio instalado e compatível com cargas de trabalho do Python. Para obter mais informações, confira Instalar o suporte ao Python no Visual Studio.

  • As instruções neste guia de início rápido se aplicam a qualquer pasta com código Python. Para seguir o exemplo descrito neste artigo, clone o repositório do GitHub gregmalcolm/python_koans para o computador, usando o seguinte comando:

    git clone https://github.com/gregmalcolm/python_koans

Não há suporte ao Visual Studio para Mac. Para obter mais informações, consulte O que está acontecendo com o Visual Studio para Mac? O Visual Studio Code no Windows, no Mac e no Linux funciona perfeitamente com o Python por meio das extensões disponíveis.

Abra a pasta do código local

Siga estas etapas para abrir uma pasta local com o código do Python existente no Visual Studio:

  1. Inicie o Visual Studio. Na janela Iniciar, selecione Abrir uma pasta local na coluna Introdução:

    Captura de tela que mostra como selecionar a opção Abrir uma pasta local quando o Visual Studio 2022 é iniciado.

    Captura de tela que mostra como selecionar a opção Abrir uma pasta local quando o Visual Studio é iniciado.

    Se estiver usando o código do repositório de exemplo python_koans, selecione a pasta python3 dentro da pasta de clone.

    Se o Visual Studio já estiver em execução, selecione Arquivo>Abrir>Pasta.

  2. Navegue até a pasta que contém o código do Python e escolha Selecionar Pasta:

    Captura de tela que mostra como selecionar a pasta local contendo o código Python existente, no Visual Studio 2022.

    Captura de tela que mostra como selecionar a pasta local contendo o código Python existente, no Visual Studio.

  3. O Visual Studio exibe os arquivos no Gerenciador de Soluções na Exibição de Pasta. Você pode expandir e recolher uma pasta usando a seta à esquerda do nome da pasta:

    Captura de tela que mostra as setas para expandir e recolher as pastas no Gerenciador de Soluções no Visual Studio 2022.

    Captura de tela que mostra as setas para expandir e recolher as pastas no Gerenciador de Soluções no Visual Studio.

  4. Ao abrir uma pasta do Python, o Visual Studio cria várias pastas ocultas para gerenciar as configurações relacionadas ao programa. Para ver essas pastas (e quaisquer outros arquivos e pastas ocultos, como a pasta .git), selecione o botão da barra de ferramentas Mostrar todos os arquivos:

    Captura de tela que mostra como exibir pastas e arquivos ocultos no Gerenciador de Soluções no Visual Studio 2022.

    Captura de tela que mostra como exibir pastas e arquivos ocultos no Gerenciador de Soluções no Visual Studio.

Execute o programa

Depois de abrir o código Python existente no Visual Studio, você pode executar o programa. Para executar o código, você precisa identificar o arquivo de inicialização (item de inicialização) ou arquivo de programa primário para o Visual Studio executar o programa. Neste exemplo, o arquivo de inicialização é contemplate-koans.py.

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no arquivo contemplate-koans.py e selecione Definir como item de inicialização:

    Captura de tela que mostra como definir o arquivo contemplate koans do Python como item de inicialização no Gerenciador de Soluções no Visual Studio 2022.

    Captura de tela que mostra como definir o arquivo contemplate koans do Python como item de inicialização no Gerenciador de Soluções no Visual Studio.

    Importante

    Se o item de inicialização não estiver localizado na raiz da pasta que você abriu, você também deverá adicionar uma linha para o arquivo JSON de configuração de inicialização conforme descrito em Definir um diretório de trabalho.

  2. Execute o código selecionando Depurar>Iniciar sem Depuração ou use o atalho de teclado Ctrl+F5. Você também pode selecionar a seta sólida de reprodução ao lado do nome do item de inicialização na barra de ferramentas do Visual Studio. Esta opção executa o código no Depurador do Visual Studio.

    Em todos esses métodos de inicialização, o Visual Studio detecta que seu item de inicialização é um arquivo Python e executa automaticamente o código no ambiente Python padrão. O ambiente atual é mostrado à direita do nome do item de inicialização na barra de ferramentas. No exemplo a seguir, o ambiente atual é Python 3.11 (64 bits):

    Captura de tela que mostra como iniciar o programa com depuração usando a seta sólida de reprodução na barra de ferramentas do Visual Studio 2022.

    Em todos esses métodos de inicialização, o Visual Studio detecta que seu item de inicialização é um arquivo Python e executa automaticamente o código no ambiente Python padrão. O ambiente atual é mostrado à direita do nome do item de inicialização na barra de ferramentas. No exemplo a seguir, o ambiente atual é Python 3.6 (32 bits):

    Captura de tela que mostra como iniciar o programa com depuração usando a seta sólida de reprodução na barra de ferramentas do Visual Studio.

    Se você não vir o Ambiente Python atual na barra de ferramentas, selecione Exibir>Outras janelas>Ambientes Python.

  3. Quando o programa é executado, o Visual Studio abre uma janela de comando para exibir a saída do programa:

    Captura de tela da janela de saída que o Visual Studio 2022 abre para a saída do programa do código do Python em execução.

    Captura de tela da janela de saída que o Visual Studio abre para a saída do programa do código do Python em execução.

    Observação

    Se você executar o programa python-koans com depuração, será necessário alterar os valores no código para que o programa conclua a execução.

  4. Você pode executar o código em um ambiente Python diferente:

    1. Expanda a lista suspensa do Ambiente Python atual na barra de ferramentas do Visual Studio e selecione o ambiente desejado.

    2. Reinicie o programa.

  5. Quando estiver pronto para fechar a pasta no Visual Studio, selecione Arquivo>Fechar pasta.

Definir diretório de trabalho

Por padrão, o Visual Studio executa um projeto do Python aberto como uma pasta na raiz da mesma pasta. No entanto, o código em seu projeto pode pressupor que o Python esteja sendo executado em uma subpasta. Quando seu código espera localizar arquivos em locais diferentes da configuração padrão reconhecida pelo Visual Studio, você talvez enfrente erros ao tentar executá-lo.

Suponha que você abra a pasta raiz do repositório python_koans e veja uma subpasta chamada python3 que contém um arquivo do Python chamado contemplate-koans.py. Você decide definir o arquivo python3/contemplate-koans.py como Arquivo de inicialização. Quando você executa o código, verá um erro informando que o arquivo denominado koans.txt não foi encontrado. O erro ocorre porque o arquivo contemplate-koans.py espera que o Python seja executado na pasta python3 em vez de na raiz do repositório.

Nesses casos, você também deve adicionar uma linha ao arquivo JSON de configuração de inicialização para especificar o diretório de trabalho:

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no arquivo de inicialização do Python (.py) e selecione Adicionar Configuração de Depuração:

    Captura de tela que mostra como selecionar a opção Adicionar configuração de depuração para um arquivo selecionado no Gerenciador de Soluções no Visual Studio 2022.

  2. Na caixa de diálogo, Selecionar Depurador, selecione a opção Padrão na lista e escolha Selecionar:

    Captura de tela que mostra como selecionar o Depurador Padrão na caixa de diálogo Selecionar um Depurador no Visual Studio 2022.

    Observação

    Se você não vir a opção Padrão, verifique se escolheu um arquivo .py do Python ao selecionar o comando Adicionar Configuração de Depuração. O Visual Studio usa o tipo de arquivo para determinar as opções do depurador para exibição.

  3. O Visual Studio abre um arquivo chamado launch.vs.json, que está localizado na pasta .vs oculta. Este arquivo descreve o contexto de depuração para o projeto. Para especificar um diretório de trabalho, adicione um valor para a propriedade "workingDirectory". Para o exemplo python-koans, você pode adicionar a propriedade e valor, "workingDirectory": "python3":

    {
  "version": "0.2.1",
  "defaults": {},
  "configurations": [
    {
      "type": "python",
      "interpreter": "(default)",
      "interpreterArguments": "",
      "scriptArguments": "",
      "env": {},
      "nativeDebug": false,
      "webBrowserUrl": "",
      "project": "contemplate_koans.py",
      "projectTarget": "",
      "name": "contemplate_koans.py",
      "workingDirectory": "python3"
    }
  ]
}

  4. Salve as alterações no arquivo launch.json.

  5. Executar o programa novamente. A execução do código agora deve ser feita na pasta especificada.

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no arquivo de inicialização do Python (.py) e selecione Configurações de Depuração e de Inicialização:

    Captura de tela que mostra como selecionar a opção Configurações de Depuração e de Inicialização para um arquivo selecionado no Gerenciador de Soluções no Visual Studio.

  2. Na caixa de diálogo, Selecionar Depurador, selecione a opção Padrão na lista e escolha Selecionar:

    Captura de tela que mostra como selecionar o Depurador Padrão na caixa de diálogo Selecionar um Depurador no Visual Studio.

    Observação

    Se você não vir Padrão como uma opção, verifique se escolheu o arquivo .py do Python ao selecionar o comando Configurações de Depuração e Inicialização. O Visual Studio usa o tipo de arquivo para determinar as opções do depurador para exibição.

  3. O Visual Studio abre um arquivo chamado launch.vs.json, que está localizado na pasta .vs oculta. Este arquivo descreve o contexto de depuração para o projeto. Para especificar um diretório de trabalho, adicione um valor para a propriedade "workingDirectory". Para o exemplo python-koans, você pode adicionar a propriedade e valor, "workingDirectory": "python3":

    {
  "version": "0.2.1",
  "defaults": {},
  "configurations": [
    {
      "type": "python",
      "interpreter": "(default)",
      "interpreterArguments": "",
      "scriptArguments": "",
      "env": {},
      "nativeDebug": false,
      "webBrowserUrl": "",
      "project": "contemplate_koans.py",
      "projectTarget": "",
      "name": "contemplate_koans.py",
      "workingDirectory": "python3"
    }
  ]
}

  4. Salve as alterações no arquivo launch.json.

  5. Executar o programa novamente. A execução do código agora deve ser feita na pasta especificada.

Conteúdo relacionado