Como Instalar Python no Linux e WSL Passo a Passo

Aprenda a configurar o ambiente Python no Linux Ubuntu ou no WSL do Windows, instalar o VS Code e rodar seus primeiros códigos sem complicação.

Para instalar o Python no Linux ou no WSL, abra o terminal e verifique se ele já existe com python3 --version. Se faltar, instale com sudo apt update && sudo apt install python3 python3-pip. Em seguida, instale o VS Code, conecte-o ao WSL e rode seu primeiro código — tudo sem complicação.

Introdução – Como Instalar Python no Linux e no WSL

Fala, impressionador(a)!

Se você usa Linux como sistema operacional principal, ou está explorando o WSL (Windows Subsystem for Linux) para programar, e quer instalar o Python, este artigo é para você. Nele, você vai aprender o caminho completo: desde a atualização dos pacotes do sistema até rodar o seu primeiro código Python dentro do VS Code, tudo no ambiente Linux.

Então, vem comigo!

Abrindo o Terminal

Tudo começa pelo terminal. Tanto no Linux quanto no WSL, ele funciona da mesma forma. A diferença é apenas em como você chega até ele.

Caso você use Linux diretamente,abra o aplicativo Terminal normalmente pelo menu do sistema. Simples assim. Com isso feito, abra o terminal do Windows e digite o comando abaixo para entrar na sua distribuição Linux (no exemplo, Ubuntu):

Codigo
wsl -d Ubuntu

Contudo, se você usa WSL no Windows, é necessário já ter o Linux instalado dentro do Windows. Para isso:

  1. Abra o Microsoft Store;
  2. Busque por “Ubuntu 24.04.1 LTS”;
  3. Faça a instalação e em seguida clique no botão Abrir;
Tela da Microsoft Store exibindo a página do Ubuntu 24.04.1 LTS, da Canonical Group Limited, com botão azul “Abrir” indicando que o aplicativo já está instalado

Ao abrir pela primeira vez, você precisará inserir o nome de usuário e senha de sua escolha. Em seguida, o ambiente será aberto.

Verificando se o Python já está instalado

Por padrão, o Ubuntu já vem com uma versão do Python instalada. Para conferir qual versão está disponível, execute:

Codigo
python3 --version

Deve aparecer algo como Python 3.12.x, significa que você já tem o Python no sistema.

Tela do terminal Ubuntu exibindo o comando python3 --version executado pelo usuário rohar@Rodrigo, retornando “Python 3.12.3”

Mesmo assim, é uma boa prática garantir que tudo está atualizado. O primeiro passo é atualizar o gerenciador de pacotes do Linux com os comandos abaixo:

Codigo
sudo apt update && sudo apt upgrade -y

O sistema vai pedir sua senha. Digite e aguarde o processo finalizar. Isso garante que você está partindo de uma base atualizada e evita conflitos durante a instalação.

Tela do terminal Ubuntu mostrando o comando python3 --version com retorno “Python 3.12.3” e, em seguida, a execução de sudo apt update && sudo apt upgrade -y, solicitando a senha do usuário rohar

Com os pacotes atualizados, agora você pode atualizar o Python:

Codigo
sudo apt upgrade python3

Tela do terminal Ubuntu mostrando a execução do comando sudo apt upgrade python3, informando que o Python 3.12.3 já está na versão mais recente

Caso você não tenha o Python instalado, você pode usar o comando abaixo para realizar a instalação:

Codigo
sudo apt install python3

No Windows e no Mac, o pip já vem junto com o Python. No Linux, é preciso instalá-lo separadamente:

Codigo
sudo apt install python3-pip
Tela do terminal Ubuntu exibindo o comando sudo apt install python3-pip, com leitura de pacotes concluída e listagem de diversas dependências e novos pacotes

O pip é fundamental para instalar bibliotecas como pandas, numpy, requests e muitas outras que você vai usar nos seus projetos.

Para confirmar que o Python está funcionando, abra o interpretador interativo:

Codigo
python3

Você vai ver algo como >>>, que é o prompt do Python. Para sair, pressione Ctrl + Z.

Tela do terminal Ubuntu mostrando a execução do comando python3, iniciando o interpretador interativo Python 3.12.3 no Linux e exibindo o prompt >>>

Instalando o VS Code

Com o Python pronto, o próximo passo é instalar um editor de código. O VS Code é a escolha mais popular para quem trabalha com Python, e o processo de instalação varia um pouco dependendo do seu cenário.

  1. Se você usa o WSL (Linux dentro do Windows): você deve baixar e instalar o VS Code para Windows normalmente;
  2. Se você usa Linux diretamente: acesse o site do VS Code e baixe o arquivo com extensão .deb (compatível com Ubuntu, Debian e derivados) ou .rpm (compatível com Red Hat, Fedora e outros).
Página oficial de download do Visual Studio Code exibindo opções para Windows, Linux (.deb e .rpm) e Mac, com destaque em botões para Windows e pacotes .deb/.rpm para Debian e Ubuntu

Depois, abra o terminal, vá até a pasta onde o arquivo foi baixado e instale:

Codigo
cd Downloads
sudo apt install <nome do arquivo>

Substitua o <nome do arquivo> pelo nome do seu instalador do VS Code, você pode digitar ./code_ e usar a tecla TAB para autocompletar o nome do arquivo. Após a instalação, pesquise por “Code” no seu sistema para abrir o VS Code.

Conectando o VS Code ao Linux (apenas para usuários WSL)

Se você usa WSL, o VS Code precisa de um passo extra para se comunicar com o seu ambiente Linux.

Dentro do VS Code, acesse a aba de extensões (Ctrl + Shift + X) e instale a extensão WSL, desenvolvida pela Microsoft.

Tela do Visual Studio Code na aba Extensions exibindo a extensão WSL da Microsoft, com o botão azul “Install” destacado para instalação

Depois de instalar:

  1. Feche e reabra o VS Code;
  2. Clique no ícone de “Open Remote Window” (canto inferior esquerdo);
  3. Escolha a opção de conectar ao WSL;
Tela do Visual Studio Code exibindo o menu de conexão remota aberto, com a opção “Connect to WSL using Distro...” destacada, além do painel inicial “Get Started with WSL” ao centro
  1. Selecione sua distribuição (ex: Ubuntu 24.04).
Menu suspenso do Visual Studio Code para selecionar a distribuição WSL, com a opção “Ubuntu-24.04” destacada para conexão

O VS Code vai reabrir já conectado ao seu ambiente Linux. A partir daqui, tudo o que você fizer dentro do editor vai rodar no Linux.

Ícone PythonPython Impressionador

Você vai aprender a linguagem de Programação que mais cresce no Mundo para fazer automações incríveis, desenvolver sites, fazer análises de dados, trabalhar com Ciência de Dados, Inteligência Artificial, mesmo que você nunca tenha tido nenhum contato com Programação na vida.

Começar agoraSeta para a direita
Fundo PythonTelas Python
Luz Python

Instalando as Extensões Essenciais

Com o VS Code aberto,  abra novamente a aba Extensions com o atalho Ctrl + Shift + X e instale as extensões que tornam o desenvolvimento em Python muito mais produtivo.

  • Python: extensão oficial da Microsoft, com recursos como autocomplete, debugger e suporte a ambientes virtuais;
Captura de tela da extensão Python da Microsoft no marketplace do Visual Studio Code, mostrando o ícone do Python, descrição do suporte à linguagem, avaliação com estrelas, número de downloads e opções como desinstalar, atualizar automaticamente e alternar para versão prévia
  • Jupyter: permite trabalhar com notebooks .ipynb, muito usados em ciência de dados e análise;
Captura de tela da extensão Jupyter da Microsoft no marketplace do Visual Studio Code, exibindo o ícone do Jupyter, descrição de suporte a notebooks interativos, avaliação com estrelas, número de downloads e opções como desinstalar, atualizar automaticamente e alternar para versão prévia
  • Dracula: tema opcional com cores agradáveis para longas sessões de programação.
Captura de tela da extensão “Dracula Theme Official” no marketplace do Visual Studio Code, exibindo o ícone do tema, nome, descrição breve, avaliação com estrelas e número de downloads

Rodando Seu Primeiro Código Python

Agora é a hora de testar tudo junto.

  1. Vá em File;
  2. Selecione a opção Open Folder;
  3. Abra (ou crie) uma pasta no seu sistema, por exemplo, codigos.
Captura de tela do Visual Studio Code mostrando o passo a passo para abrir uma pasta: menu File selecionado (1), opção Open Folder… destacada (2) e janela de seleção exibindo o caminho /home/rohar/codigos para confirmação (3)

Dentro dessa pasta, crie um novo arquivo chamado codigo.py e escreva:

Codigo
print("Meu primeiro código em Python")

Clique no botão de executar (ou pressione F5). O terminal vai abrir e exibir:

Meu primeiro código em Python

Captura de tela do Visual Studio Code com o arquivo codigos.py aberto, exibindo o comando print("Meu primeiro código em Python") e o terminal mostrando a execução do script com a saída “Meu primeiro código em Python” no ambiente WSL Ubuntu 24.04

Conclusão

Instalar o Python no Linux pode parecer mais trabalhoso do que no Windows, mas seguindo o passo a passo você percebe que é bem direto. Em resumo, você precisa: atualizar os pacotes do sistema, instalar o Python e o pip, configurar o VS Code (com ou sem a extensão WSL, dependendo do seu ambiente) e testar com um código simples.

Com o ambiente configurado, você está pronto para criar projetos, instalar bibliotecas e evoluir na programação Python, seja no Linux nativo ou dentro do WSL.

Se você quer acelerar sua jornada com uma estrutura completa, didática testada e suporte sempre que precisar, conheça nosso minicurso gratuito de Python e o  Curso Completo de Python.

Além disso, se preferir esse conteúdo no formato de vídeo-aula, assista ao vídeo abaixo ou acesse o nosso canal do YouTube!

O que você aprende neste vídeo

Resposta rápida: A aula mostra o mesmo caminho para quem usa o Linux como sistema e para quem usa o Linux dentro do Windows (WSL), e onde eles se separam: no Ubuntu, o VS Code entra pelo arquivo .deb; no WSL, entra pelo instalador do Windows e se conecta ao Linux depois. Instalar o Linux no Windows fica fora da aula.

Neste vídeo (14 min):

  • 1:48 - Confere com python3 --version: o Ubuntu já vem com um Python instalado, e o dele era o 3.12.
  • 2:16 - Atualiza os pacotes do Linux com dois comandos sudo apt ligados por &&, o segundo com -y, e digita a senha.
  • 2:58 - Quem já tem o Python o atualiza com o upgrade do apt; quem não tem o instala com sudo apt install python3.
  • 3:59 - Instala o pip com sudo apt install python3-pip.
  • 4:42 - Testa digitando python3 no terminal, que abre o Python ali mesmo; a aula segue pelo VS Code, que ele considera mais eficiente.
  • 5:20 - Na página de download do VS Code, o caminho se divide: no Ubuntu, baixa o arquivo .deb; no WSL, o instalador do Windows, que se instala com dois cliques e a instalação padrão.
  • 6:54 - No Linux como sistema, não há duplo clique: no terminal, entra na pasta de downloads com cd, e dá para listar os arquivos com ls para achar o instalador.
  • 8:21 - Roda sudo apt install com o nome do instalador, que começa com code: digita o começo e o Tab completa o resto.
  • 9:11 - Só no WSL: instala no VS Code a extensão WSL, da Microsoft.
  • 9:40 - Ainda só no WSL, reabre o VS Code, clica em Open Remote Window, na parte de baixo da janela, e conecta ao Ubuntu, onde o Python foi instalado.
  • 10:15 - Nos dois sistemas, instala a extensão Python (a padrão, não a de debugger) e a Jupyter, para os arquivos .ipynb; o tema Dracula, que colore o código, entra como recomendação dele.
  • 12:46 - Roda um print de teste num arquivo .py, numa pasta criada para os códigos, e o terminal que abre é o do Linux, e não o do Windows.

Trechos do vídeo:

  • Quem já instalou o Python no Windows ou no Mac não precisa instalá-lo no Linux: o caminho do Linux é para quem usa o Linux como sistema ou faz questão de rodar o Python dentro do WSL.
  • No Linux, o pip, gerenciador de bibliotecas do Python, não vem com o Python e precisa ser instalado à parte, mesmo por quem já tinha o Python; na instalação por executável, no Windows ou no Mac, ele já vem junto.
  • A extensão WSL é o que faz o VS Code usar o Python do Linux, e não o do Windows; quem usa o Linux como sistema não precisa dela nem da conexão, porque ali o VS Code já abre no Linux.

Perguntas frequentes

1. Como saber se o Python já está instalado no Linux?

Abra o terminal e digite python3 –version. Se aparecer um número de versão, ele já está instalado. A maioria das distribuições Linux já vem com o Python 3 por padrão.

2. Como instalar o Python no Ubuntu?

No terminal, rode sudo apt update e depois sudo apt install python3 python3-pip. Isso instala o Python 3 e o gerenciador de pacotes pip, usado para instalar bibliotecas.

3. O que é o WSL e por que usá-lo para Python?

O WSL (Subsistema do Windows para Linux) permite rodar um Linux dentro do Windows. É útil para Python porque oferece um ambiente Linux real, comum em servidores, sem precisar de uma máquina separada.

4. Como rodar Python no VS Code?

Instale o VS Code e a extensão oficial de Python. Abra a pasta do projeto, crie um arquivo .py e use o botão de executar (ou o terminal integrado) para rodar o código diretamente no editor.

Hashtag Treinamentos

Para acessar outras publicações de Python, clique aqui!


Quer aprender mais sobre Python com um minicurso básico gratuito?

Posts mais recentes de Python

Posts mais recentes da Hashtag Treinamentos