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

Neste início rápido, você segue as etapas guiadas para executar o código 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 Python existente de uma pasta. Os mesmos recursos e comandos estão disponíveis para o desenvolvimento de código do Python como quando você opta por trabalhar com um projeto.

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.
As instruções neste início rápido se aplicam a qualquer pasta com código Python. Para acompanhar o exemplo descrito neste artigo, clone o gregmalcolm/python_koans repositório GitHub em seu computador usando o seguinte comando:
```
git clone https://github.com/gregmalcolm/python_koans
```

Não há suporte para o Visual Studio para Mac. O Visual Studio Code no Windows, Mac e Linux funciona bem com o Python por meio de extensões disponíveis.

Abrir a pasta de código local

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

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

Se o Visual Studio já estiver em execução, você poderá selecionar Arquivo>Abrir>Pasta em vez disso.
Navegue até a pasta que contém seu código Python e escolha Selecionar Pasta:
O Visual Studio exibe os arquivos no Gerenciador de Soluções no Modo de Exibição de Pasta. Você pode expandir e recolher uma pasta usando a seta à esquerda do nome da pasta:
Quando você abre 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 a opção Mostrar Todos os Arquivos da barra de ferramentas:

Executar o programa

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

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:

Importante

Se o Item de Inicialização não estiver localizado na raiz da pasta aberta, você também deverá adicionar uma linha ao arquivo JSON de configuração de inicialização, conforme descrito no diretório de trabalho Set.
Execute o código selecionando Depurar>Iniciar sem Depuração ou use o atalho Ctrl+F5. Você também pode selecionar a seta de reprodução sólida ao lado do nome do Item de Inicialização na barra de ferramentas do Visual Studio. Essa opção executa o código no Depurador do Visual Studio.

Para todos esses métodos de início, o Visual Studio detecta que o 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):

Se você não vir o Ambiente Python atual na barra de ferramentas, selecione Exibir>Outras janelas>Ambientes do Python.
Quando o programa é executado, o Visual Studio abre uma janela de comando para exibir a saída do programa:

Observação

Se você executar o python-koans programa com depuração, precisará alterar valores no código para que o programa conclua a execução.
Você pode executar o código em um ambiente diferente do Python:
1. Expanda a lista suspensa atual do Ambiente python na barra de ferramentas do Visual Studio e selecione o ambiente desejado.
2. Reinicie seu programa.
Quando estiver pronto para fechar a pasta de código 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 dessa mesma pasta. No entanto, o código em seu projeto pode esperar que o Python seja executado em uma subpasta. Quando o código espera encontrar arquivos em locais diferentes da configuração padrão reconhecida pelo Visual Studio, você pode experimentar erros ao tentar executar o código.

Suponha que você abra a pasta raiz do python_koans repositório e veja uma subpasta chamada python3 que contém um arquivo Python chamado contemplate-koans.py. Você decide definir o arquivo python3/contemplate-koans.py como o Arquivo de Inicialização. Ao executar o código, você verá um erro em que um arquivo chamado koans.txt não pode ser encontrado. O erro ocorre porque o arquivo contemplate-koans.py espera que o Python seja executado na pasta python3 em vez da 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:

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:
Na caixa de diálogo Selecionar Depurador , selecione a opção Padrão na lista e escolha Selecionar:

Observação

Se você não vir Padrão como uma opção, certifique-se de escolher um arquivo Python .py ao selecionar o comando Adicionar Configuração de Depuração. O Visual Studio usa o tipo de arquivo para determinar quais opções de depurador exibir.

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 do projeto. Para especificar um diretório de trabalho, adicione um valor para a "workingDirectory" propriedade. Para o python-koans exemplo, você pode adicionar a propriedade e o 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"
    }
  ]
}

Salve suas alterações no arquivo launch.vs.json .
Execute seu programa novamente. A execução do código agora deve ser executada na pasta especificada.

Comentários

Esta página foi útil?

Last updated on 2025-12-12