Como resolver problemas de WSL no Windows 11

Se o WSL (Subsistema Windows para Linux) parar de funcionar repentinamente ou apresentar erros na sua máquina com Windows 11, é bastante frustrante — especialmente quando você está apenas tentando realizar um trabalho de verdade.Às vezes, é apenas uma questão de Windows desatualizado ou talvez o WSL nem esteja habilitado corretamente. Este guia aborda algumas das correções comuns.É definitivamente imprevisível, mas, na maioria das vezes, essas etapas têm ajudado as pessoas a recuperar seus ambientes Linux sem uma reinstalação completa. Prepare-se para verificar suas atualizações, ativar alguns recursos e executar alguns comandos. Nada muito complexo, mas às vezes pode parecer tentar consertar o Windows sem ajuda.

Como corrigir o WSL que não funciona no Windows 11

Certifique-se de que o Windows esteja totalmente atualizado

Geralmente, essa é a primeira coisa a verificar — o WSL depende de alguns recursos do Windows que podem estar com bugs ou desatualizados. Se a sua versão do Windows 11 não estiver atualizada, o WSL pode se comportar mal ou se recusar a iniciar. Para verificar, acesse Configurações > Windows Update e clique em Verificar atualizações. Se houver alguma, instale-a e reinicie.Às vezes, apenas obter os patches mais recentes corrige o bug, porque a Microsoft tende a lançar correções relacionadas ao WSL ocultas nas atualizações. Em algumas configurações, reiniciar após a atualização pode parecer inútil, mas é melhor prevenir. Já vi algumas máquinas em que o WSL começa a funcionar magicamente após uma reinicialização adequada após a atualização — o que é meio estranho, mas, ei, funciona.

Habilitar o recurso WSL por meio do menu de recursos do Windows

Este é meio básico, mas não o pule. Se o WSL não estiver habilitado no nível do sistema operacional, nada funcionará, não importa quais comandos você execute. Então, vá em Pesquisar e digite “Recursos do Windows”.Clique em Ativar ou desativar recursos do Windows. Em seguida, role para baixo e encontre Subsistema Windows para Linux. Certifique-se de que esteja marcado. Além disso, considere habilitar a Plataforma de Máquina Virtual, pois o WSL 2 precisa dela para funcionar corretamente. Depois de clicar em OK, o Windows solicitará que você reinicie. Repita essas etapas se o WSL ainda não funcionar após a reinicialização. Porque, é claro, o Windows precisa torná-lo um pouco mais frustrante do que o necessário. Em algumas máquinas, isso não ativa imediatamente, então uma segunda reinicialização pode ajudar.

Verifique sua instalação e configurações do WSL

Depois que tudo estiver habilitado, abra o PowerShell como administrador e execute este comando:

wsl --list --verbose

Isso verifica quais distribuições estão instaladas e seus estados atuais. Se mostrar erros ou mencionar um estado ruim, pode ser necessário reinstalar sua distribuição Linux ou até mesmo o próprio WSL.Às vezes, o mecanismo do WSL fica no limbo e precisa de uma atualização — basicamente, reinicializar o WSL para redefinir seu estado. Em alguns casos, atualizar manualmente para o WSL 2 ajuda. Executar wsl --set-default-version 2— isso garante que você esteja usando a versão mais recente e rápida, especialmente se estiver com problemas de desempenho ou falhas estranhas. Enquanto isso, em uma configuração, funcionou imediatamente; em outra, tive que executar isso duas vezes antes de registrar.

Reinstale o WSL se algo ainda estiver quebrado

Se nada mais funcionar, tente fazer uma redefinição completa. Acesse Configurações > Aplicativos > Recursos Opcionais. Se o WSL aparecer, desinstale-o. Caso contrário, pule para a próxima etapa. Para remover o WSL completamente, pode ser necessário usar comandos do PowerShell como:

dism /online /disable-feature /featurename:Microsoft-Windows-Subsystem-Linux /norestart

e o mesmo vale para a Plataforma de Máquina Virtual. Após desabilitar, reinicie e reative o WSL marcando a caixa de seleção novamente no menu Recursos do Windows e, em seguida, reinicie. Pode parecer tedioso, mas às vezes a configuração interna do WSL fica tão problemática que uma reinstalação limpa é a única solução.

Dicas extras e armadilhas comuns

Certifique-se de que sua versão do Windows seja compatível com WSL 2 (Windows 11 versão 21H2 ou superior).Você pode ver as informações da sua compilação em Configurações > Sistema > Sobre.
Execute wsl --set-default-version 2regularmente se quiser melhor compatibilidade e velocidade.
Se praticamente nada funcionar, verifique se a virtualização está habilitada na BIOS.Às vezes, a tecnologia de virtualização (Intel VT-x ou AMD-V) é desabilitada sem que você perceba. Você encontrará isso em Configurações > Privacidade e segurança > Segurança do Windows > Segurança do dispositivo > Isolamento de núcleo e integridade da memória.
E, claro, certifique-se de que sua distribuição (como Ubuntu ou Debian) esteja instalada corretamente executando o guia oficial de instalação do WSL da Microsoft.

Encerramento

Basicamente, essas etapas resolvem os problemas habituais quando o WSL começa a apresentar problemas.Às vezes, é uma questão de atualizações; outras vezes, uma instalação limpa ou um ajuste de configuração. Não sei por que funciona, mas em uma máquina, uma reinicialização após habilitar o recurso resolveu o problema; em outra, foi habilitar a Plataforma de Máquina Virtual. Um pouco de paciência ajuda bastante, já que o Windows pode ser um pouco imprevisível com esses recursos. Dedos cruzados, para que isso ajude alguém a voltar ao seu fluxo de trabalho do Linux sem precisar se preocupar.

Resumo

Verifique se há atualizações do Windows e reinicie
Habilitar WSL e plataforma de máquina virtual nos recursos do Windows
Execute wsl --list --verbosepara verificar o estado da sua distribuição
Defina WSL 2 como padrão comwsl --set-default-version 2
Reinstale ou reinicie o WSL se necessário
Certifique-se de que a virtualização esteja habilitada no BIOS