Instalar o Python pela página oficial, conferindo se a versão escolhida ainda está em manutenção ativa.
Adicionar a extensão Python ao VS Code, sem a qual o editor não sabe como executar um arquivo `.py`.
Criar uma pasta de trabalho e um primeiro arquivo `.py` com um exemplo mínimo de código.
Selecionar o interpretador correto no VS Code, inclusive quando o projeto usar um ambiente virtual.
Quem decide programar em Python no VS Code costuma buscar um editor leve, gratuito e mantido de forma independente da linguagem, sem depender de um ambiente de desenvolvimento pesado ou pago.
Este guia mostra o caminho completo, desde a instalação do Python e do editor até a execução do primeiro arquivo, funcionando de forma equivalente em Windows, macOS e Linux.
Ao final dos passos, o objetivo prático é ter um arquivo Python criado, o interpretador correto selecionado dentro do editor e o código em execução.
O que instalar antes de começar
Python é uma linguagem gratuita, mantida por uma comunidade ativa, com grande variedade de bibliotecas também gratuitas e frequentemente descrita como acessível para quem está começando a programar.
Teste vocacional
Qual carreira combina com o seu perfil?
Responda as perguntas e descubra o curso certo e as bolsas ideais para você!
O instalador do Python para qualquer sistema operacional deve ser obtido na página oficial de downloads do Python, que também lista quais versões estão em manutenção ativa e quais já passaram da data de fim de suporte.
Depois de instalar o Python o passo seguinte é instalar o VS Code e, dentro dele, a extensão Python.
Criando seu primeiro arquivo Python
Com o Python e o VS Code instalados, o próximo passo é organizar o projeto antes de escrever qualquer código.
Crie uma pasta dedicada ao projeto, com um nome curto e sem espaços ou acentos, para evitar problemas de caminho em alguns sistemas.
Abra essa pasta no VS Code pelo menu de arquivos, para que o editor trate todo o conteúdo como um único projeto.
Crie um arquivo novo dentro dela com a extensão `.py`, por exemplo `primeiro_script.py`.
Escreva uma instrução simples nesse arquivo, como `print(“Olá, mundo”)`, e salve o arquivo antes de tentar executá-lo.
Esse exemplo mínimo serve apenas para confirmar que o editor reconhece o arquivo como um script Python e que o ambiente está pronto para a etapa seguinte, que é apontar qual interpretador deve rodar esse código.
Configurando o interpretador no VS Code
O interpretador é o programa Python instalado na máquina que efetivamente lê e executa o código do arquivo `.py`. O VS Code não decide isso automaticamente em todos os casos, por isso é preciso indicar qual instalação de Python o editor deve usar para aquele projeto.
Um caminho para isso passa por criar um ambiente virtual próprio para o projeto, com um comando como `python -m venv venv`, e ativar esse ambiente antes de selecionar o interpretador dentro do VS Code.
O caminho do script usado para ativar esse ambiente virtual varia conforme o sistema operacional: em Windows, ele costuma estar dentro de uma pasta chamada `Scripts`, enquanto em outros sistemas costuma estar em uma pasta chamada `bin`.
Depois de decidir se o projeto vai usar um ambiente virtual ou a instalação global do Python, abra a paleta de comandos do VS Code e busque a opção de seleção de interpretador Python.
Executando o código: botão e terminal
Depois de escrever o arquivo `.py` e selecionar o interpretador, restam duas formas de rodar o código dentro do próprio VS Code: um controle de execução visível no editor e o terminal integrado, que aceita comandos digitados manualmente.
A posição exata desse controle, o atalho de teclado associado a ele e o texto exibido no terminal podem variar entre versões do editor, do sistema operacional e da própria extensão Python instalada, por isso vale conferir cada elemento na tela antes de seguir os próximos passos.
Quando o Python não roda no VS Code: causas comuns
Antes de revisar o código em busca de erros, vale conferir alguns pontos que respondem por boa parte das falhas relatadas ao tentar executar um script Python dentro do VS Code.
Um primeiro ponto é o próprio controle de execução. Quando esse controle aparece sem a cor esperada ou simplesmente não faz nada ao ser acionado, a causa costuma estar na ausência ou na instalação incompleta da extensão Python.
Um segundo ponto, independente de qualquer extensão, é a ausência de um interpretador selecionado para aquele projeto específico: sem essa indicação explícita, o VS Code pode não saber qual instalação de Python usar, mesmo com a extensão presente e ativa.
Um terceiro ponto envolve a própria instalação do Python. Parte das falhas de execução são atribuídas a uma versão do Python instalada na máquina que já não recebe atualizações.
Essa recomendação tem base concreta: nem toda versão do Python continua recebendo suporte indefinidamente. A versão 3.9, por exemplo, chegou ao fim de vida com o lançamento 3.9.25, e seu suporte terminou em 31 de outubro de 2025.
Em resumo, revise nesta ordem antes de suspeitar de um erro no código:
se a extensão Python está instalada e ativa no VS Code;
se o interpretador certo está selecionado para aquele projeto;
se a versão instalada do Python ainda está em manutenção.
Perguntas frequentes
Preciso instalar o Python separadamente do VS Code?
Sim. O VS Code é um editor de código e não inclui um interpretador Python embutido. É necessário instalar o Python separadamente antes de o editor conseguir executar qualquer arquivo `.py`.
O que faz a extensão Python dentro do VS Code?
Ela conecta o editor ao interpretador Python instalado na máquina, permitindo selecionar essa instalação, executar o código e acessar recursos voltados especificamente para essa linguagem; sem ela, o VS Code trata o arquivo `.py` como um texto comum, sem capacidade de execução.
VS Code é o mesmo programa que Visual Studio?
Não. São produtos diferentes: o Visual Studio é um ambiente de desenvolvimento completo, mais pesado, voltado sobretudo a linguagens como C# e C++; o VS Code é um editor de código mais leve, multiplataforma, que depende de extensões para ganhar recursos específicos de cada linguagem, incluindo Python.
O que é o interpretador que o VS Code pede para selecionar?
É a instalação de Python que vai efetivamente executar o código do arquivo aberto. Pode ser a instalação global do sistema ou um ambiente virtual criado para aquele projeto específico; a seleção é feita dentro do próprio VS Code, na lista de interpretadores disponíveis.
Por que o comando python pode não funcionar no terminal?
Isso costuma acontecer quando o Python não foi adicionado ao caminho de execução do sistema durante a instalação, quando existe mais de uma versão instalada e o comando aponta para a errada, ou quando o interpretador selecionado no VS Code não corresponde a nenhuma instalação válida na máquina.
Qual versão do Python devo instalar?
A orientação prática é instalar uma versão listada como em manutenção ativa na página oficial de downloads do Python, evitando versões já marcadas como fim de vida, como é o caso da série 3.9, encerrada em 31 de outubro de 2025.
Como começar a estudar programação do zero?
Se você quer se dar o primeiro passo no mercado de tecnologia e aprender uma linguagem de programação, conte com a Allevo Tech.
A plataforma oferece formações práticas em áreas de alta demanda, como Engenharia de Software, Ciência de Dados e Inteligência Artificial.
As trilhas são estruturadas para desenvolver competências técnicas e preparar você para os desafios do mercado de trabalho.
Clique no botão abaixo e conheça as formações da Allevo Tech que podem impulsionar a sua trajetória profissional.
Ver publicações 
