O WSL (Windows Subsystem for Linux) é um recurso oficial da Microsoft que permite rodar um ambiente Linux completo diretamente dentro do Windows — sem precisar de máquina virtual, sem dual boot, sem formatar nada. Você abre um terminal Linux e o Windows continua funcionando normalmente ao lado. Este tutorial mostra como instalar, configurar e aproveitar ao máximo o WSL no seu dia a dia.
O que é o WSL e para que serve?
O WSL integra o kernel do Linux diretamente ao Windows, permitindo rodar comandos, ferramentas e até aplicativos gráficos do Linux sem sair do Windows.
Quem usa o WSL:
- Desenvolvedores que precisam de ferramentas Linux (Git, Python, Node, Docker)
- Estudantes aprendendo Linux sem abrir mão do Windows
- Profissionais de segurança e redes que usam ferramentas como nmap, curl, ssh
- Quem precisa rodar scripts shell no Windows
Diferença entre WSL 1 e WSL 2:
| WSL 1 | WSL 2 | |
|---|---|---|
| Kernel Linux | Emulado | Real (kernel completo) |
| Compatibilidade | Parcial | Total |
| Velocidade de I/O | Mais rápida no disco Windows | Mais rápida no disco Linux |
| Docker | Limitado | Suporte completo |
| Recomendado | Não | Sim |
Use sempre o WSL 2 — é mais completo, estável e compatível.
Requisitos
Antes de instalar, verifique se seu sistema atende:
- Windows 10 versão 2004 (build 19041) ou superior
- Windows 11 — qualquer versão
- Virtualização habilitada na BIOS (na maioria dos PCs já vem ativa)
Para verificar sua versão do Windows pressione Win + R, digite winver e pressione Enter.
Parte 1 — Instalação do WSL
Método rápido — Um único comando
A Microsoft simplificou a instalação do WSL a um único comando. É a forma recomendada.
- Clique no menu Iniciar, pesquise por PowerShell
- Clique com o botão direito e selecione Executar como Administrador
- Digite o comando abaixo e pressione Enter:
wsl --install
Esse comando faz tudo automaticamente:
- Ativa os recursos necessários do Windows
- Instala o WSL 2
- Baixa e instala o Ubuntu (distribuição padrão)
- Instala o kernel Linux atualizado
- Aguarde o download e a instalação (pode levar alguns minutos)
- Reinicie o computador quando solicitado
Após reiniciar
O Ubuntu vai abrir automaticamente e pedir para você criar um usuário:
Enter new UNIX username: seu_usuario
New password: (digite uma senha — os caracteres não aparecem na tela)
Retype new password: (confirme a senha)
Escolha um nome de usuário simples, sem espaços ou caracteres especiais. A senha do Linux é independente da senha do Windows.
Parte 2 — Instalando outras distribuições
O Ubuntu é instalado por padrão, mas o WSL suporta várias distribuições Linux.
Ver distribuições disponíveis
wsl --list --online
As principais disponíveis:
| Distribuição | Indicada para |
|---|---|
| Ubuntu 22.04 | Iniciantes, uso geral |
| Ubuntu 24.04 | Versão mais recente do Ubuntu |
| Debian | Estabilidade e leveza |
| Kali Linux | Segurança e pentest |
| openSUSE | Uso corporativo |
| Fedora | Desenvolvedores Red Hat |
| Alpine | Leveza extrema, containers |
Instalar uma distribuição específica
wsl --install -d Debian
wsl --install -d kali-linux
Ver distribuições instaladas
wsl --list --verbose
A saída mostra o nome, o estado e a versão do WSL de cada distro:
NAME STATE VERSION
* Ubuntu Running 2
Debian Stopped 2
O * indica a distribuição padrão.
Definir distribuição padrão
wsl --setdefault Ubuntu
Parte 3 — Abrindo o terminal Linux
Após a instalação, você tem várias formas de abrir o terminal Linux:
Pelo menu Iniciar Pesquise pelo nome da distribuição (Ubuntu, Debian etc.) e clique no ícone.
Pelo Windows Terminal O Windows Terminal detecta automaticamente as distribuições instaladas. Clique na seta ao lado do + na barra de abas e escolha a distribuição.
Pelo Explorador de Arquivos Clique com o botão direito em qualquer pasta → Abrir no Terminal Linux (disponível no Windows 11).
Pelo PowerShell ou CMD
wsl # abre a distribuição padrão
wsl -d Debian # abre uma distribuição específica
Parte 4 — Configurando o ambiente
Atualizar os pacotes
A primeira coisa a fazer após instalar é atualizar o sistema:
sudo apt update && sudo apt upgrade -y
Instalar ferramentas essenciais
# Ferramentas de desenvolvimento básicas
sudo apt install -y build-essential curl wget git unzip zip
# Editor de texto no terminal
sudo apt install -y nano vim
# Utilitários de rede
sudo apt install -y net-tools iputils-ping dnsutils
Instalar linguagens de programação
Python:
sudo apt install -y python3 python3-pip python3-venv
python3 --version
Node.js (via NVM — recomendado):
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts
node --version
Java:
sudo apt install -y default-jdk
java --version
PHP:
sudo apt install -y php php-cli php-mbstring
php --version
Parte 5 — Acessando arquivos entre Windows e Linux
Uma das partes mais importantes do WSL é a integração entre os sistemas de arquivos.
Acessar arquivos do Windows pelo Linux
O disco C: do Windows fica disponível em /mnt/c/ no Linux:
ls /mnt/c/Users/SeuUsuario/Desktop # lista a Área de Trabalho do Windows
cd /mnt/c/Users/SeuUsuario/Documents # entra na pasta Documentos do Windows
Para ir direto para a pasta do seu usuário Windows:
cd /mnt/c/Users/$(cmd.exe /c "echo %USERNAME%" 2>/dev/null | tr -d '\r')
Acessar arquivos do Linux pelo Windows
No Explorador de Arquivos do Windows, acesse:
\\wsl$\Ubuntu\home\seu_usuario
Ou simplesmente abra o Explorador de Arquivos e procure Linux no painel esquerdo — as distribuições instaladas aparecem lá.
Abrir pasta Linux no VS Code diretamente
cd ~/meu-projeto
code .
O VS Code abre automaticamente com a extensão Remote — WSL, conectado ao ambiente Linux.
Dica de desempenho: Para projetos que rodam no Linux, mantenha os arquivos dentro do sistema de arquivos Linux (
/home/usuario/) e não no/mnt/c/. O acesso a arquivos dentro do Linux é muito mais rápido.
Parte 6 — WSL com VS Code
A integração do WSL com o Visual Studio Code é um dos maiores atrativos do recurso.
Configurar
- Instale o VS Code no Windows normalmente
- Instale a extensão WSL (Remote – WSL) no VS Code
- No terminal Linux, navegue até seu projeto e digite:
code .
O VS Code abre no Windows, mas executa tudo no ambiente Linux — terminal, extensões, servidor de linguagem. É a experiência de desenvolvimento Linux com a interface do Windows.
Benefícios práticos
- Terminal integrado do VS Code roda Bash nativamente
- Extensões como ESLint, Prettier e Python rodam no Linux
- Hot reload e ferramentas de build funcionam no ambiente correto
- Sem problemas de compatibilidade de caminhos de arquivo
Parte 7 — WSL com Docker
O WSL 2 tem integração nativa com o Docker Desktop, eliminando a necessidade de máquina virtual separada.
Configurar Docker no WSL
- Baixe e instale o Docker Desktop no Windows
- Abra o Docker Desktop → Settings → Resources → WSL Integration
- Ative a integração para a sua distribuição Linux
- Clique em Apply & Restart
Agora, no terminal Linux:
docker --version
docker run hello-world
docker compose up
Tudo funciona como em um Linux nativo, mas gerenciado pelo Docker Desktop no Windows.
Parte 8 — Aplicativos gráficos Linux no Windows
O WSL 2 no Windows 11 suporta WSLg — a capacidade de rodar aplicativos com interface gráfica do Linux diretamente no Windows, sem configuração adicional.
Instalar e rodar um app gráfico
# Instalar o editor de texto gráfico Gedit
sudo apt install -y gedit
gedit
# Instalar o gerenciador de arquivos Nautilus
sudo apt install -y nautilus
nautilus
# Instalar o GIMP
sudo apt install -y gimp
gimp
O aplicativo abre como qualquer janela do Windows, aparece na barra de tarefas e pode ser minimizado e maximizado normalmente.
Parte 9 — Comandos essenciais de gerenciamento do WSL
Todos executados no PowerShell do Windows:
# Ver todas as distribuições instaladas
wsl --list --verbose
# Iniciar uma distribuição
wsl -d Ubuntu
# Desligar o WSL completamente
wsl --shutdown
# Reiniciar uma distribuição específica
wsl --terminate Ubuntu
# Atualizar o WSL
wsl --update
# Ver a versão do WSL instalada
wsl --version
# Exportar uma distribuição (backup)
wsl --export Ubuntu C:\backup-ubuntu.tar
# Importar uma distribuição (restaurar backup)
wsl --import Ubuntu C:\WSL\Ubuntu C:\backup-ubuntu.tar
# Desinstalar uma distribuição
wsl --unregister Ubuntu
Parte 10 — Configuração avançada com .wslconfig
O arquivo .wslconfig permite personalizar os recursos de hardware alocados para o WSL. Crie ou edite o arquivo em:
C:\Users\SeuUsuario\.wslconfig
Exemplo de configuração:
[wsl2]
memory=4GB # RAM máxima alocada para o WSL
processors=2 # Número de CPUs
swap=2GB # Memória swap
localhostForwarding=true
Após salvar, reinicie o WSL:
wsl --shutdown
wsl
Por padrão o WSL pode usar até metade da RAM do sistema. Se você tem 16 GB, limitar a 4 GB ou 6 GB mantém o Windows responsivo.
Problemas comuns e soluções
WSL não instala — erro de virtualização Acesse a BIOS/UEFI do seu computador e ative a opção Intel VT-x ou AMD-V (varia conforme o fabricante).
Comando wsl --install não funciona Verifique se o Windows está atualizado. Abra o Windows Update e instale todas as atualizações pendentes.
WSL está muito lento Certifique-se de que está usando a versão 2:
wsl --list --verbose
wsl --set-version Ubuntu 2
Sem acesso à internet no WSL
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf
VS Code não conecta ao WSL Reinstale a extensão WSL no VS Code e certifique-se de que o WSL está rodando antes de abrir o editor.
Resumo — Checklist de instalação
| Etapa | Comando / Ação |
|---|---|
| Instalar WSL | wsl --install no PowerShell Admin |
| Reiniciar o PC | Obrigatório após instalação |
| Criar usuário Linux | Feito automaticamente na primeira abertura |
| Atualizar pacotes | sudo apt update && sudo apt upgrade -y |
| Instalar ferramentas | sudo apt install build-essential git curl |
| Acessar arquivos Win | /mnt/c/Users/SeuUsuario/ |
| Acessar Linux pelo Win | \\wsl$\Ubuntu no Explorador |
| Integrar VS Code | code . dentro do terminal Linux |
| Configurar Docker | Docker Desktop → WSL Integration |
| Limitar RAM | Arquivo .wslconfig na pasta do usuário |
Dica final: O WSL mudou completamente a forma de desenvolver no Windows. Se você é desenvolvedor ou está aprendendo programação, instalar o WSL é um dos primeiros passos que recomendo — você tem o melhor dos dois mundos: os aplicativos e jogos do Windows com as ferramentas e o terminal do Linux, tudo no mesmo computador sem complicação.
- Como Usar o WSL — Linux dentro do Windows
- Como Usar os Atalhos (Shortcuts) no iPhone
- Como Ativar as Opções de Desenvolvedor no Android
- Atalhos de Teclado Essenciais do macOS
- Comandos Essenciais do Terminal Linux para Iniciantes
amazon amd Android apple backup bios cmd Computador CPU desempenho dicas de informática Dicas de Tecnologia DISM google Hardware IA impressora Intel internet iphone Linux MAC Macos microsoft NVIDIA otimização PowerShell Produtividade ram REDE Samsung segurança SFC Software SSD Sysadmin tecnologia TI troubleshooting Tutoriais tutoriais Windows tutorial windows Windows 10 Windows 11