Como instalar e usar o WSL 2 no Windows 11

Configurar o WSL 2 no Windows 11 deveria ser bem simples, mas na prática, às vezes parece que você se depara com obstáculos aleatórios — como recursos que não são ativados corretamente ou comandos que não funcionam como esperado. Se as etapas típicas de instalação deixaram você confuso ou preso no meio de um comando que simplesmente não executa, não se preocupe — você não está sozinho.Às vezes, o Windows simplesmente complica as coisas um pouco mais do que deveria. Talvez você já tenha ativado alguns recursos, mas as coisas ainda não estejam funcionando corretamente, ou a versão do WSL não esteja atualizando adequadamente.É esse tipo de frustração que este guia visa resolver.

Encontrou algum problema durante a instalação? Talvez os comandos para ativar recursos não sejam aplicados após a reinicialização, ou o aplicativo Linux instalado ainda mostre WSL 1 em vez de 2? É irritante, mas existem alguns truques que costumam resolver esses problemas sem precisar reinstalar o Windows ou vasculhar logs obscuros. Abaixo, você encontrará alguns métodos práticos que resolveram a maioria desses problemas típicos de instalação do WSL. Cada solução é baseada em técnicas que funcionaram em instalações complexas e reais.

Como corrigir problemas comuns de instalação do WSL 2 no Windows 11

Ative os recursos corretamente — às vezes, reiniciar não resolve o problema.

Esta é a primeira coisa a verificar. Você pode ter executado os comandos para habilitar os recursos Subsistema Windows para Linux e Plataforma de Máquina Virtual, mas se esses recursos não estiverem realmente ativados ou se, de alguma forma, foram desativados novamente após a reinicialização, isso causará diversos problemas. Não sei por que isso acontece, mas às vezes executar os comandos pelo PowerShell como administrador não habilita completamente os recursos até que você reinicie o sistema corretamente.

• Abra o PowerShell como administrador ( Windows + X, e selecione Windows PowerShell (Admin)).
• Execute estes comandos exatamente da seguinte forma:
• DISM. EXE /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart Isso habilita o próprio WSL. Certifique-se de que não haja erros de digitação.Às vezes, o Windows pode apresentar comportamentos inesperados e reverter o recurso se algo estiver errado, portanto, fique atento a erros durante a execução do comando.
• DISM. EXE /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart Este comando ativa a camada de virtualização necessária para o WSL 2. Se algum dos comandos retornar um erro informando que o recurso não foi encontrado, verifique a versão do Windows ou se o seu sistema oferece suporte à virtualização na BIOS.

Após executar ambos os procedimentos, é fundamental reiniciar o computador, e não apenas encerrar a sessão. Use o Menu Iniciar > Energia > Reiniciar.Às vezes, as configurações parecem funcionar corretamente após a reinicialização, mas o Windows ainda pode apresentar problemas. Em alguns computadores, esse procedimento falha na primeira tentativa, mas funciona após uma segunda reinicialização ou um desligamento rápido e inicialização.

Certifique-se de que seu sistema suporte virtualização e que ela esteja habilitada na BIOS.

Este é um problema comum: se a virtualização estiver desativada na BIOS, o WSL 2 não funcionará corretamente, mesmo que você tenha ativado os recursos do Windows. Para verificar, abra o Gerenciador de Tarefas ( Ctrl + Shift + Esc), vá para a guia Desempenho e procure por Virtualização. Se estiver como “desativada”, você precisará reiniciar o computador e acessar a BIOS (geralmente pressionando F2, F10, Del ou similar na inicialização, dependendo do seu sistema).Lá, encontre a configuração chamada “Tecnologia de Virtualização Intel” ou “AMD-V” e ative-a. Salve as alterações, reinicie o computador e verifique novamente.

Atualize ou reinstale o kernel do WSL 2 manualmente.

Se os comandos para definir o WSL 2 como padrão continuarem falhando, ou se a versão ainda mostrar teimosamente “1”, talvez o kernel não esteja instalado corretamente. Acesse a página de atualização do kernel do WSL2 da Microsoft e baixe o pacote mais recente. Execute-o como administrador, reinicie e tente definir o padrão novamente com:

wsl --set-default-version 2

Em algumas configurações, essa etapa não é necessária, mas em outras, ela resolve aquele problema persistente do “WSL 1” após a instalação de uma distribuição.

Limpe e reinicie o WSL se as coisas ficarem muito instáveis.

Se tudo estiver completamente quebrado ou a distribuição não iniciar, considere redefinir o WSL completamente.É uma medida drástica, mas possível.

• Abra o PowerShell como administrador.
• Execute este comando wsl --shutdownpara interromper todas as distribuições em execução.
• Em seguida, execute o comando para cada distribuição que você instalou. Isso a excluirá do WSL sem afetar a loja de aplicativos ou arquivos fora do WSL.wsl --unregister distroName
• Reinstale a distribuição Linux diretamente da Microsoft Store — basta procurar sua distribuição favorita e instalar novamente.Às vezes, uma instalação limpa após a restauração é a única maneira de corrigir configurações corrompidas ou binários quebrados.

É claro que o Windows precisa complicar as coisas mais do que o necessário. Essas etapas já salvaram instalações que se recusavam a cooperar, principalmente após atualizações do Windows ou instalações parciais.É meio estranho, mas uma combinação de ativar e desativar recursos, atualizar o kernel e garantir que a virtualização esteja habilitada geralmente resolve esses problemas pela raiz.

Resumo

• Execute o PowerShell como administrador e habilite os recursos do WSL e da Máquina Virtual.
• Reinicie o sistema após ativar os recursos — não pule esta etapa.
• Verifique o suporte à virtualização na BIOS e habilite-o, se necessário.
• Atualize o kernel do WSL2 manualmente, se necessário.
• Reinicie o WSL se algo estiver completamente quebrado.

Resumo

Executar o WSL 2 em uma máquina teimosa pode exigir alguns ajustes, mas esses métodos testados e comprovados resolvem a maioria dos problemas comuns.Às vezes, o Windows só quer ter certeza de que você realmente deseja executar o Linux integralmente — ou então está sendo obstinado sem motivo aparente. Se ainda assim não funcionar, talvez a atualização mais recente do Windows corrija os bugs que quebram o subsistema novamente. De qualquer forma, vale a pena tentar essas etapas antes de desistir de tudo e começar do zero. Espero que isso ajude algumas pessoas a economizar algumas horas de frustração.

---

---