Como Instalar Python no VSCode em 2026

Para usar Python no VSCode, você precisa instalar três componentes separados: o Visual Studio Code, a extensão Python da Microsoft e um interpretador Python no computador. O VSCode não inclui a linguagem Python por conta própria.

Neste guia, você vai configurar tudo no Windows, macOS ou Linux, selecionar a versão correta do Python, criar um ambiente virtual, executar o primeiro arquivo e instalar bibliotecas com pip.

Resposta rápida: instale o Python e o VSCode, adicione a extensão Python publicada pela Microsoft, abra uma pasta de projeto e execute o comando Python: Create Environment. Depois, selecione o interpretador da pasta .venv e use o botão Run Python File.

O que precisa ser instalado?

Essa diferença é importante. Instalar apenas a extensão não instala o Python, e instalar apenas o Python não adiciona ao VSCode os recursos de edição e depuração.

1. Instale o Visual Studio Code

1. Acesse a página oficial de download do VSCode.
2. Baixe a versão correspondente ao Windows, macOS ou Linux.
3. Conclua a instalação com as opções recomendadas.
4. Abra o VSCode para confirmar que o editor inicia normalmente.

No Windows, habilitar as opções para adicionar o VSCode ao menu de contexto e ao PATH facilita abrir uma pasta pelo terminal com code ., mas isso não é obrigatório para seguir o tutorial.

2. Instale o Python no computador

O processo muda um pouco conforme o sistema operacional. Caso use Windows e queira um guia ainda mais detalhado, consulte também como instalar Python no Windows.

Windows

Nas versões atuais, o site oficial pode oferecer o Python Install Manager. Ele gerencia versões do Python e disponibiliza os comandos python, py e pymanager.

1. Acesse Python.org Downloads.
2. Instale o gerenciador ou o instalador recomendado para o Windows.
3. Caso apareça o instalador clássico, marque Add python.exe to PATH antes de continuar.
4. Feche e abra novamente o terminal e o VSCode depois da instalação.

Abra o Prompt de Comando ou o terminal do VSCode e verifique:

python --version
py list

Em instalações mais antigas, py -3 --version também pode confirmar a versão disponível. Se o comando python iniciar a instalação de uma versão estável, siga as instruções exibidas pelo gerenciador.

macOS

Não use a instalação de sistema do macOS como ambiente principal de desenvolvimento. A documentação do VSCode recomenda instalar uma versão própria com um gerenciador como o Homebrew.

brew install python3
python3 --version

Caso o comando brew não exista, instale primeiro o Homebrew pelo site oficial do projeto ou baixe o instalador do Python em Python.org.

Linux

Muitas distribuições já incluem Python 3. No Ubuntu e no Debian, você pode instalar também o suporte a ambientes virtuais e ao pip:

sudo apt update
sudo apt install python3 python3-pip python3-venv
python3 --version

Em outras distribuições, use o gerenciador de pacotes correspondente. Evite remover ou substituir o Python usado internamente pelo sistema.

3. Instale a extensão Python da Microsoft

1. Abra o VSCode.
2. Clique em Extensions na barra lateral ou pressione Ctrl+Shift+X.
3. Pesquise por Python.
4. Confirme que o publicador é Microsoft e clique em Install.

A extensão adiciona IntelliSense, execução, seleção de interpretadores, integração com ambientes e outros recursos. O suporte de depuração é fornecido pela extensão Python Debugger, normalmente instalada junto com a extensão principal.

4. Abra uma pasta para o projeto

Trabalhe dentro de uma pasta, não apenas com um arquivo solto. Isso permite que o VSCode associe o interpretador e as configurações ao projeto correto.

1. Crie uma pasta chamada primeiro-projeto-python.
2. No VSCode, acesse File > Open Folder.
3. Selecione a pasta criada.
4. Confirme a confiança no conteúdo somente se a pasta e os arquivos forem seus ou vierem de uma fonte confiável.

5. Crie um ambiente virtual no VSCode

Um ambiente virtual mantém as bibliotecas de cada projeto separadas. Isso evita conflitos entre versões e reduz alterações desnecessárias na instalação global do Python.

1. Pressione Ctrl+Shift+P. No macOS, use Cmd+Shift+P.
2. Execute Python: Create Environment.
3. Selecione Venv.
4. Escolha o interpretador Python instalado anteriormente.
5. Aguarde a criação da pasta .venv.

Também é possível criar o ambiente pelo terminal:

# Windows
py -m venv .venv

# macOS e Linux
python3 -m venv .venv

Ao abrir um novo terminal no VSCode, a extensão costuma ativar automaticamente o ambiente selecionado. Caso precise ativá-lo manualmente:

# Windows, Prompt de Comando
.venv\Scripts\activate.bat

# macOS e Linux
source .venv/bin/activate

No PowerShell, o arquivo é .venv\Scripts\Activate.ps1. Se a política de execução bloquear o script, use o Prompt de Comando no terminal integrado em vez de alterar configurações de segurança sem entender o impacto.

6. Selecione o interpretador Python correto

O VSCode precisa saber qual versão executará o projeto. A escolha afeta a execução, o depurador, o IntelliSense e as bibliotecas reconhecidas.

1. Clique na versão do Python exibida na barra inferior do VSCode.
2. Ou abra a paleta e execute Python: Select Interpreter.
3. Escolha o interpretador localizado dentro da pasta .venv.

Para conferir qual executável está ativo, abra um novo terminal e rode:

python -c "import sys; print(sys.executable)"
python --version

7. Crie e execute seu primeiro código

1. Crie um arquivo chamado main.py.
2. Adicione o código abaixo.

nome = input("Qual é o seu nome? ")
print(f"Olá, {nome}! Python está funcionando no VSCode.")

Existem três maneiras simples de executar:

• clique no botão triangular Run Python File no canto superior direito;
• clique com o botão direito no editor e escolha Run Python > Run Python File in Terminal;
• abra o terminal integrado e execute python main.py.

A tecla F5 inicia o modo de depuração. Para apenas rodar o arquivo, o botão Run Python File costuma ser mais direto.

8. Instale bibliotecas no ambiente correto

Abra um novo terminal depois de selecionar a .venv. O nome do ambiente deve aparecer no início da linha. Instale uma biblioteca usando o próprio interpretador selecionado:

python -m pip install requests

O formato python -m pip reduz o risco de instalar o pacote em outra versão do Python. Para registrar as dependências do projeto:

python -m pip freeze > requirements.txt

Em outra máquina ou ambiente, o arquivo pode ser usado assim:

python -m pip install -r requirements.txt

Depois da configuração, você pode praticar com estes projetos simples em Python ou seguir o guia de como programar em Python.

Como depurar Python no VSCode

1. Clique à esquerda do número de uma linha para criar um ponto de interrupção.
2. Pressione F5.
3. Na primeira execução, selecione Python File.
4. Use a barra de depuração para continuar, avançar uma linha, entrar em uma função ou encerrar.

O depurador permite observar variáveis e entender o caminho percorrido pelo programa sem adicionar vários comandos print().

Erros comuns e como corrigir

Python não foi encontrado

Feche e abra novamente o VSCode e o terminal. No Windows, teste python --version, py list e py -3 --version. Verifique também os aliases de execução de aplicativos caso o comando abra a Microsoft Store ou não encontre o gerenciador.

O interpretador não aparece na lista

Abra uma pasta de projeto, reinicie o VSCode e execute novamente Python: Select Interpreter. Se necessário, escolha a opção para informar manualmente o caminho do executável.

ModuleNotFoundError

Normalmente, a biblioteca foi instalada em outro ambiente. Selecione a .venv, abra um novo terminal e instale o pacote com python -m pip install nome-do-pacote.

O terminal usa outra versão do Python

Selecione novamente o interpretador e crie um novo terminal. Confira o resultado de python -c "import sys; print(sys.executable)". O caminho deve apontar para o ambiente esperado.

O botão de executar não aparece

Confirme que o arquivo termina em .py, que a extensão Python da Microsoft está ativa e que um interpretador foi selecionado.

Perguntas frequentes

Preciso instalar Python dentro do VSCode?

Não. O interpretador é instalado no sistema operacional. O VSCode usa a extensão Python para localizar e utilizar esse interpretador.

Qual extensão Python devo instalar?

Instale a extensão chamada Python, publicada pela Microsoft. Verifique o nome do publicador para evitar extensões não relacionadas.

Qual versão do Python devo selecionar?

Para projetos novos, prefira uma versão estável e compatível com as bibliotecas usadas. Dentro de cada projeto, selecione o interpretador da pasta .venv.

VSCode é uma IDE para Python?

O VSCode é um editor extensível que pode oferecer recursos semelhantes aos de uma IDE quando configurado com extensões. Para comparar outras opções, veja as melhores IDEs para Python.

Como atualizar a versão usada pelo VSCode?

Instale a nova versão do Python no sistema e depois execute Python: Select Interpreter. Ambientes virtuais antigos continuam ligados à versão com a qual foram criados, portanto pode ser necessário recriar a .venv.

Como verificamos as informações

• documentação oficial do tutorial Python no Visual Studio Code;
• documentação oficial sobre seleção e criação de ambientes;
• documentação atual do Python para instalação no Windows;
• processo revisado em 14 de julho de 2026.

Fontes: tutorial oficial de Python no VSCode, ambientes Python no VSCode e documentação do Python no Windows.

Conclusão

Para instalar Python no VSCode corretamente, configure o editor, a extensão e o interpretador como componentes separados. Depois, abra uma pasta de projeto, crie uma .venv e confirme que o VSCode selecionou esse ambiente.

Com o primeiro arquivo funcionando, avance para pequenos exercícios, instalação de bibliotecas e depuração. Para entender melhor a linguagem antes dos projetos, consulte também o que é Python e como aprender Python.