Início rápido: Abra e execute código Python numa pasta no Visual Studio

Neste quickstart, segue passos guiados para executar código Python no Visual Studio 2019 e posteriores sem ter de criar um projeto Visual Studio. O Visual Studio facilita a abertura e execução de código Python existente a partir de uma pasta. As mesmas funcionalidades e comandos estão disponíveis para o seu desenvolvimento de código Python que quando escolhe trabalhar com um projeto.

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.
As instruções deste quickstart aplicam-se a qualquer pasta com código Python. Para seguir o exemplo descrito neste artigo, clone o gregmalcolm/python_koans repositório do GitHub para o seu computador usando o seguinte comando:
```
git clone https://github.com/gregmalcolm/python_koans
```

O Visual Studio para Mac não é suportado. O Visual Studio Code no Windows, Mac e Linux funciona bem com Python através das extensões disponíveis.

Abrir a pasta de código local

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

Inicie o Visual Studio. Na janela de início, selecione Abrir uma pasta local na coluna Começar :

Se o Visual Studio já estiver a funcionar, pode escolher Ficheiro>Abrir>Pasta em vez disso.
Navegue até à pasta que contém o seu código Python e escolha Selecionar Pasta:
O Visual Studio mostra os ficheiros no Explorador de Soluções na Vista de Pastas. Pode expandir e dobrar uma pasta usando a seta à esquerda do nome da pasta:
Quando abres uma pasta Python, o Visual Studio cria várias pastas ocultas para gerir definições relacionadas com o programa. Para ver estas pastas (e quaisquer outros ficheiros e pastas ocultos, como a pasta .git ), selecione a opção Mostrar Todos os Ficheiros :

Execute o programa

Depois de abrir o código Python existente no Visual Studio, pode executar o programa. Para executar o código, é necessário identificar o Ficheiro de Arranque (Item de Arranque) ou ficheiro principal do programa para o Visual Studio executar o programa. Neste exemplo, o ficheiro de arranque é contemplate-koans.py.

No Explorador de Soluções, clique com o botão direito no ficheiro contemplate-koans.py e selecione Definir como Item de Arranque:

Importante

Se o seu Item de Arranque não estiver localizado na raiz da pasta que abriu, deve também adicionar uma linha ao ficheiro JSON de configuração de lançamento, conforme descrito em Definir diretório de trabalho.
Execute o código selecionando Debug>Start sem Debugar ou use o atalho de teclado Ctrl+F5. Também podes selecionar a seta de reprodução sólida ao lado do nome do Item de Arranque na barra de ferramentas do Visual Studio. Esta opção executa o código no Visual Studio Debugger.

Para todos estes métodos de início, o Visual Studio deteta que o seu Item de Arranque é um ficheiro Python e executa automaticamente o código no ambiente Python predefinido. O ambiente atual é mostrado à direita do nome do Item de Arranque na barra de ferramentas. No exemplo seguinte, o ambiente atual é Python 3.11 (64 bits):

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

Observação

Se executares o python-koans programa com depuração, precisas de alterar valores no código para que o programa complete a execução.
Podes correr o código num ambiente Python diferente:
1. Expanda a lista suspensa atual do Ambiente Python na barra de ferramentas do Visual Studio e selecione o ambiente desejado.
2. Reinicia o teu programa.
Quando estiver pronto para fechar a pasta de código no Visual Studio, selecione Ficheiro>Fechar pasta.

Definir diretório de trabalho

Por defeito, o Visual Studio executa um projeto Python aberto como uma pasta na raiz dessa mesma pasta. No entanto, o código do teu projeto pode esperar que o Python seja executado num subdiretório. Quando o seu código espera encontrar ficheiros em locais diferentes da configuração padrão reconhecida pelo Visual Studio, pode ter erros ao tentar executar o código.

Suponha que abre a pasta raiz do python_koans repositório e vê uma subpasta chamada python3 que contém um ficheiro Python chamado contemplate-koans.py. Decides definir o ficheiro python3/contemplate-koans.py como ficheiro de arranque. Quando executas o código, vês um erro que indica que um ficheiro chamado koans.txt não pode ser encontrado. O erro ocorre porque o ficheiro contemplate-koans.py espera que o Python corra na pasta python3 em vez da raiz do repositório.

Nesses casos, deve também adicionar uma linha ao ficheiro JSON de configuração de lançamento para especificar o diretório de trabalho:

No Explorador de Soluções, clique com o botão direito no Ficheiro de Arranque em Python (.py) e selecione Adicionar Configuração de Depuração:
No diálogo Selecionar Depurador , selecione a opção Padrão na lista e depois selecione Selecionar:

Observação

Se não vires Default como opção, certifica-te de escolher um ficheiro Python .py quando selecionares o comando Adicionar Configuração de Depuração. O Visual Studio utiliza o tipo de ficheiro para determinar quais as opções de depuração a mostrar.

O Visual Studio abre um ficheiro chamado launch.vs.json, que está localizado na pasta oculta .vs . Este ficheiro descreve o contexto de depuração do projeto. Para especificar um diretório funcional, adicione um valor para a "workingDirectory" propriedade. Neste python-koans exemplo, pode adicionar a propriedade e o respetivo 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"
    }
  ]
}

Guarda as tuas alterações no ficheirolaunch.vs.json .
Executa o teu programa novamente. A execução do código deve agora correr na pasta especificada.

Feedback

Esta página foi útil?

Last updated on 2025-12-12