Aprenda a instalar Python, configurar a extensão, selecionar o interpretador e executar seu primeiro arquivo no VS Code em Windows, macOS e Linux.
Em resumo:
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.
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.
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.
Com o Python e o VS Code instalados, o próximo passo é organizar o projeto antes de escrever qualquer código.
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.
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.
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.
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:
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`.
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.
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.
É 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.
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.
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.
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.
Em resumo: Como trabalhar no IML? O primeiro passo é escolher uma função e verificar a escolaridade exigida para ela. O Instituto Médico Legal reúne profissionais com atribuições diferentes, e não existe um único curso que permita exercer todas as atividades. Encontre bolsas de estudo de até 80% Para quem procura uma formação técnica, o […]
Ferramentas de IA podem ajudar gestores e equipes de projetos a planejar atividades, acompanhar indicadores, automatizar tarefas e produzir relatórios. Conheça 10 opções que podem ser usadas no dia a dia.
Profissionais atuam na área da visão, mas possuem formações e atribuições diferentes; conheça os cursos e os limites de cada carreira
