Introdução ao WSL2 - Como Usar Linux no Windows
O que é o WSL2?
O WSL2 (Windows Subsystem for Linux 2) permite executar um ambiente Linux completo diretamente no Windows — sem máquina virtual, sem dual boot. Vem com o Windows 10 (versão 2004+) e o Windows 11.
Ao contrário do WSL1, o WSL2 inclui um kernel Linux real, o que significa que Docker, systemd e praticamente todas as ferramentas Linux funcionam como esperado. Para quem está aprendendo Linux em um PC com Windows, o WSL2 é o ponto de partida mais prático disponível hoje.
O que você pode fazer com o WSL2
- Executar Ubuntu, Debian, Fedora e outras distribuições Linux no Windows
- Executar containers Docker nativamente
- Configurar ambientes de desenvolvimento com Python, Node.js e outras ferramentas
- Escrever e executar shell scripts
- Editar arquivos Linux diretamente no VS Code via Remote - WSL
Quais são os requisitos do sistema para o WSL2?
Você precisa do Windows 10 versão 2004 (build 19041) ou posterior, ou Windows 11, com virtualização (VT-x / AMD-V) habilitada no BIOS.
| Requisito | Mínimo |
|---|---|
| SO | Windows 10 versão 2004 (build 19041+) ou Windows 11 |
| Arquitetura | x64 ou ARM64 |
| Virtualização | Habilitada no BIOS/UEFI |
Verifique sua versão do Windows executando winver na caixa de diálogo Executar (Win+R).
Para verificar se a virtualização está habilitada, abra o Gerenciador de Tarefas (Ctrl+Shift+Esc) → Desempenho → CPU → procure "Virtualização: Habilitada".
Como instalar o WSL2?
No Windows 11 e Windows 10 (Atualização de outubro de 2021 ou posterior), um único comando instala o WSL2 e o Ubuntu juntos.
1. Abra o PowerShell ou Prompt de Comando como Administrador
Clique com o botão direito no botão Iniciar e selecione "Terminal do Windows (Admin)" ou pesquise "PowerShell" e execute como Administrador.
2. Execute o comando de instalação
wsl --install
Installing: Virtual Machine Platform Virtual Machine Platform has been installed. Installing: Windows Subsystem for Linux Windows Subsystem for Linux has been installed. Installing: Ubuntu Ubuntu has been installed. The requested operation is successful.
3. Reinicie o computador
Após a reinicialização, a configuração do Ubuntu inicia automaticamente. Defina um nome de usuário e senha para concluir a configuração.
A senha que você definir aqui é necessária sempre que você executar comandos sudo. Anote-a em algum lugar seguro.
Instalando uma distribuição específica
Para ver as distribuições disponíveis:
wsl --list --online
NAME FRIENDLY NAME Ubuntu Ubuntu Debian Debian GNU/Linux kali-linux Kali Linux Rolling Ubuntu-22.04 Ubuntu 22.04 LTS Ubuntu-24.04 Ubuntu 24.04 LTS ...
Para instalar uma específica:
wsl --install -d Ubuntu-24.04
Verificar a instalação
wsl -l -v
NAME STATE VERSION * Ubuntu Running 2 Ubuntu-24.04 Stopped 2
A coluna VERSION deve mostrar 2 para WSL2.
Qual distribuição Linux devo escolher?
Para a maioria dos usuários, o Ubuntu é a escolha certa — tem a maior comunidade, mais documentação, e o gerenciador de pacotes apt torna a instalação de ferramentas simples.
| Distribuição | Características | Melhor para |
|---|---|---|
| Ubuntu | Grande comunidade, gerenciador apt | Iniciantes, desenvolvimento geral |
| Debian | Leve, focado em estabilidade | Usuários com experiência em servidor |
| Kali Linux | Coleção de ferramentas de segurança | Aprendizes de segurança |
| openSUSE | Ferramentas de nível empresarial | Fluxos de trabalho corporativos |
Em caso de dúvida, escolha Ubuntu LTS. Cinco anos de suporte, cobertura máxima de documentação.
Como começar a usar Linux no WSL2?
Inicie o WSL2 pesquisando "Ubuntu" no menu Iniciar, ou digite wsl em qualquer janela do PowerShell/Prompt de Comando.
wsl
Dentro do shell Linux, você pode executar comandos Linux padrão:
# Mostrar diretório atual pwd
/home/username
# Listar arquivos com detalhes ls -la
# Atualizar listas de pacotes (sempre execute após a configuração inicial) sudo apt update && sudo apt upgrade -y
Desligar o WSL2
# Encerrar uma distro específica wsl --terminate Ubuntu # Desligar todas as instâncias WSL wsl --shutdown
Como compartilhar arquivos entre Windows e Linux?
O WSL2 monta os drives do Windows em /mnt/ (por exemplo, drive C: em /mnt/c/), e o Windows pode acessar arquivos Linux via \\wsl$\Ubuntu no Explorador de Arquivos.
Acessando arquivos do Windows pelo WSL2
# Navegar pelo drive C: ls /mnt/c/Users/ # Copiar um arquivo para os Documentos do Windows cp meuarquivo.txt /mnt/c/Users/usuario/Documents/
Abrindo arquivos Linux no Explorador de Arquivos do Windows
De dentro do shell Linux, execute:
explorer.exe .
Isso abre o diretório Linux atual no Explorador de Arquivos. Você também pode digitar \\wsl$\Ubuntu\home\usuario diretamente na barra de endereços do Explorador de Arquivos.
Para melhor desempenho, mantenha seus arquivos de trabalho dentro do diretório home do Linux (/home/usuario/) em vez do sistema de arquivos do Windows (/mnt/c/...). I/O de arquivos entre sistemas operacionais é significativamente mais lento.
Editando arquivos Linux no VS Code
Instale a extensão "Remote - WSL" no VS Code, depois execute isso do seu shell WSL2:
code .
O VS Code abre com acesso completo ao sistema de arquivos Linux, terminal e extensões sendo executadas dentro do Linux.
Como resolver erros comuns do WSL2?
Erro "Virtualization is not enabled"
Causa: VT-x / AMD-V está desabilitado no BIOS.
Solução: Reinicie o computador, entre na tela de configuração do BIOS/UEFI (geralmente F2 ou DEL), e habilite a opção de virtualização.
wsl --install falha em versões mais antigas do Windows 10
Em versões do Windows 10 1903–2004, pode ser necessário habilitar componentes manualmente:
# Execute no PowerShell (Admin) dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Reinicie, depois baixe e instale o pacote de atualização do kernel Linux para WSL2 da Microsoft, depois defina o WSL2 como padrão:
wsl --set-default-version 2
Erro 0x80370102: WslRegisterDistribution falhou
Causa: Hyper-V ou Virtual Machine Platform não está habilitado.
Solução:
# Execute no PowerShell (Admin) dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Reinicie e tente novamente.
Senha esquecida
# No PowerShell (Admin) — inicie a distro como root ubuntu config --default-user root # Dentro do WSL2, redefina a senha passwd username # Restaure o usuário padrão ubuntu config --default-user username
Substitua ubuntu pelo nome real do comando da sua distro (por exemplo, ubuntu2404) se necessário.