Comment résoudre les problèmes WSL sous Windows 11

Si WSL (Windows Subsystem for Linux) cesse soudainement de fonctionner ou génère des erreurs sur votre machine Windows 11, c’est assez frustrant, surtout lorsque vous essayez simplement de travailler efficacement. Parfois, il s’agit simplement d’une version obsolète de Windows, ou peut-être même que WSL n’est pas correctement activé. Ce guide présente quelques solutions courantes. C’est un peu aléatoire, mais la plupart du temps, ces étapes ont aidé les utilisateurs à remettre leur environnement Linux en marche sans réinstallation complète. Attendez-vous à vérifier vos mises à jour, activer quelques fonctionnalités et exécuter quelques commandes. Rien de bien compliqué, mais cela peut parfois donner l’impression de tenter de réparer Windows à la va-vite.

Comment réparer WSL qui ne fonctionne pas sous Windows 11

Assurez-vous que Windows est entièrement à jour

C’est généralement la première chose à vérifier : WSL s’appuie sur certaines fonctionnalités Windows qui peuvent être boguées ou obsolètes. Si votre version de Windows 11 n’est pas à jour, WSL pourrait mal fonctionner ou refuser de démarrer. Pour vérifier, accédez à Paramètres > Windows Update et cliquez sur Rechercher les mises à jour. S’il y en a, installez-les, puis redémarrez. Parfois, le simple fait d’installer les derniers correctifs corrige le bug, car Microsoft a tendance à déployer des correctifs liés à WSL cachés dans les mises à jour. Sur certaines configurations, un redémarrage après une mise à jour peut sembler inutile, mais il vaut mieux être prudent. J’ai vu quelques machines où WSL se mettait à fonctionner comme par magie après un redémarrage correct après une mise à jour ; c’est un peu étrange, mais bon, ça marche.

Activer la fonctionnalité WSL via le menu des fonctionnalités Windows

Cette étape est assez basique, mais ne l’ignorez pas. Si WSL n’est pas activé au niveau du système d’exploitation, rien ne fonctionnera, quelles que soient les commandes exécutées. Ouvrez la recherche et saisissez « Fonctionnalités Windows ».Cliquez sur « Activer ou désactiver des fonctionnalités Windows ».Ensuite, faites défiler la page jusqu’à « Sous-système Windows pour Linux ». Assurez-vous qu’elle est cochée. Pensez également à activer la plateforme de machine virtuelle, car WSL 2 en a besoin pour fonctionner correctement. Après avoir cliqué sur OK, Windows vous demandera de redémarrer. Répétez ces étapes si WSL ne fonctionne toujours pas après le redémarrage. Bien sûr, Windows doit rendre la situation un peu plus frustrante qu’elle ne devrait l’être. Sur certaines machines, cette option ne s’active pas immédiatement ; un second redémarrage peut donc être utile.

Vérifiez votre installation et vos configurations WSL

Une fois que tout est activé, ouvrez PowerShell en tant qu’administrateur et exécutez cette commande :

wsl --list --verbose

Cette fonction vérifie les distributions installées et leur état actuel. Si des erreurs ou un état incorrect sont signalés, vous devrez peut-être réinstaller votre distribution Linux, voire WSL. Parfois, le moteur WSL est en panne et nécessite une actualisation, ce qui revient à redémarrer WSL pour réinitialiser son état. Dans certains cas, une mise à niveau manuelle vers WSL 2 est utile. Exécuterwsl --set-default-version 2 : cette fonction garantit que vous utilisez la version la plus récente et la plus rapide, surtout si vous rencontrez des problèmes de performances ou des erreurs inhabituelles. Sur une configuration, cela a fonctionné immédiatement ; sur une autre, j’ai dû exécuter cette fonction deux fois avant qu’elle ne soit enregistrée.

Réinstallez WSL si des éléments sont toujours défectueux

Si rien ne fonctionne, essayez une réinitialisation complète. Accédez à Paramètres > Applications > Fonctionnalités optionnelles. Si WSL apparaît, désinstallez-le. Sinon, passez à l’étape suivante. Pour supprimer complètement WSL, vous devrez peut-être utiliser des commandes PowerShell telles que :

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

Il en va de même pour la plateforme de machines virtuelles. Après la désactivation, redémarrez, puis réactivez WSL en cochant à nouveau la case dans le menu Fonctionnalités de Windows, puis redémarrez. Cela peut paraître fastidieux, mais parfois, la configuration interne de WSL est tellement défectueuse qu’une réinstallation complète est la seule solution.

Conseils supplémentaires et pièges courants

Assurez-vous que votre version de Windows prend en charge WSL 2 (Windows 11 version 21H2 ou supérieure).Vous pouvez consulter les informations de votre build dans Paramètres > Système > À propos.
Exécutez wsl --set-default-version 2régulièrement si vous souhaitez une meilleure compatibilité et une meilleure vitesse.
Si rien ne fonctionne, vérifiez si la virtualisation est activée dans le BIOS. Il arrive que la technologie de virtualisation (Intel VT-x ou AMD-V) soit désactivée sans que vous vous en rendiez compte. Vous trouverez cette information dans Paramètres > Confidentialité et sécurité > Sécurité Windows > Sécurité de l’appareil > Isolation des cœurs et intégrité de la mémoire.
Et, bien sûr, assurez-vous que votre distribution (comme Ubuntu ou Debian) est correctement installée en exécutant le guide d’installation officiel WSL de Microsoft.

Conclure

En gros, ces étapes répondent aux problèmes habituels lorsque WSL commence à poser problème. Parfois, il s’agit de mises à jour ; d’autres fois, d’une nouvelle installation ou d’une modification de paramètres. Je ne sais pas pourquoi cela fonctionne, mais sur une machine, un redémarrage après l’activation de la fonctionnalité a résolu le problème ; sur une autre, c’était l’activation de la plateforme de machine virtuelle. Un peu de patience est indispensable, car Windows peut être assez imprévisible avec ces fonctionnalités. Espérons que cela puisse aider quelqu’un à retrouver son flux de travail Linux sans s’arracher les cheveux.

Résumé

Vérifiez les mises à jour Windows et redémarrez
Activer WSL et la plateforme de machine virtuelle dans les fonctionnalités Windows
Exécutez wsl --list --verbosepour vérifier l’état de votre distribution
Définir WSL 2 par défaut avecwsl --set-default-version 2
Réinstaller ou réinitialiser WSL si nécessaire
Assurez-vous que la virtualisation est activée dans le BIOS