Installer le sous-système Windows pour Linux peut être un peu déroutant au début, surtout avec les différentes façons dont Windows gère désormais les fonctionnalités. Parfois, vous l’activez, mais il ne semble pas fonctionner immédiatement : pas de shell Linux, ou il génère constamment des erreurs. Ou peut-être l’avez-vous installé, mais votre distribution ne démarre pas, ou des commandes sont manquantes ? C’est frustrant quand tout ne se passe pas comme prévu, surtout parce que Windows complique un peu plus que nécessaire la configuration. Ce guide est là pour vous aider à résoudre les problèmes courants et à vous assurer que WSL fonctionne correctement. Que vous le fassiez pour le développement, l’apprentissage ou simplement pour bricoler, l’objectif est d’obtenir enfin un environnement Linux fonctionnel et simple.
Comment résoudre les problèmes de configuration du sous-système Windows pour Linux
Assurez-vous que WSL est correctement activé dans Windows
C’est généralement la première chose à vérifier, car si la petite case à cocher dans Panneau de configuration > Programmes > Activer ou désactiver des fonctionnalités Windows n’est pas correctement cochée, le reste n’aura aucune importance. Parfois, même après avoir coché « Sous-système Windows pour Linux », un redémarrage est nécessaire. Mais surtout, sur les versions plus récentes de Windows, il est important de s’assurer que la plateforme de machine virtuelle est également activée, car WSL 2 en dépend. Pour cela, cochez les deux cases et redémarrez :
DISM /Online /Enable-Feature /FeatureName:Microsoft-Windows-Subsystem-Linux /All /NoRestart DISM /Online /Enable-Feature /FeatureName:VirtualMachinePlatform /All /NoRestart Redémarrez ensuite votre PC. Sur certaines configurations, le fonctionnement ne fonctionnera pas si les deux fonctionnalités ne sont pas activées de cette manière. Pour information, il est conseillé de vérifier que votre version de Windows prend en charge WSL 2 (Windows 10, version 1903+).Pour le vérifier, appuyez sur Win + R, saisissez winver, puis assurez-vous qu’elle est suffisamment récente.
Mettre à jour les composants Windows et WSL
Si WSL est activé, mais que la distribution ne se lance toujours pas ou que les commandes plantent, il est conseillé de tout mettre à jour. Accédez à Paramètres > Mise à jour et sécurité > Rechercher les mises à jour. Même un petit correctif peut résoudre les problèmes de compatibilité. N’oubliez pas : une fois que vous avez tout activé, vous devez mettre à jour votre noyau Linux manuellement, en particulier pour WSL 2. Microsoft fournit un package de mise à jour du noyau Linux ; téléchargez-le ici. Exécutez le programme d’installation et vous verrez une barre de progression. Cette étape est souvent ignorée, mais elle est essentielle pour le bon fonctionnement de WSL 2.
Réinstallez ou réinitialisez votre distribution Linux si nécessaire
Si votre distribution s’installe mais refuse de démarrer ou se comporte bizarrement, elle est peut-être corrompue ou obsolète. Pour résoudre ce problème, accédez à Paramètres > Applications > Applications et fonctionnalités. Trouvez votre distribution Linux, cliquez dessus et essayez les « Options avancées » pour la réinitialiser ou la désinstaller et la réinstaller depuis le Microsoft Store. Parfois, une simple suppression et une réinstallation suffisent à résoudre des bugs étranges. Par exemple, si Ubuntu plante constamment au lancement, sa réinitialisation peut corriger les points d’entrée perturbés lors de l’installation.
Exécutez les commandes WSL depuis PowerShell pour le dépannage
Si des commandes telles que wsl --list --verboseafficher des erreurs ou ne répertorient pas correctement vos distributions installées, ouvrez PowerShell en tant qu’administrateur et procédez comme suit :
wsl --shutdown wsl --update wsl --set-default-version 2 Cela permet de réinitialiser le sous-système et de garantir que vous utilisez WSL 2. Parfois, le simple fait de changer la version par défaut ou de forcer l’arrêt corrige les processus bloqués. Sur certaines machines, un redémarrage après ces commandes stabilise l’ensemble. Vérifiez également si la version WSL de votre distribution correspond à ceci :
wsl --list --verbose Si ce n’est pas la version 2, définissez-le explicitement avec :
wsl --set-version 2 Vérifiez vos paramètres BIOS/UEFI
C’est un peu bizarre, mais si la virtualisation est désactivée dans le BIOS/UEFI, WSL 2 ne fonctionnera pas correctement. Redémarrez votre ordinateur, accédez au BIOS (généralement en appuyant sur Delou F2au démarrage), puis recherchez des paramètres comme Intel VT-x ou AMD-V. Activez-le s’il est désactivé. Enregistrez et redémarrez. Parfois, Windows peut sembler prêt, mais la virtualisation matérielle nécessite une activation manuelle. Sur ma configuration, l’activation a résolu de nombreux problèmes de démarrage de WSL 2.
Maintenant, si tout cela est trop compliqué ou si vous êtes coincé dans un état étrange, cela vaut généralement la peine d’essayer de désinstaller puis de réinstaller proprement votre distribution Linux via le Microsoft Store, ou même de réinitialiser entièrement WSL en utilisant :
wsl --unregister Cela supprime complètement la distribution et supprime toutes les données corrompues. Ensuite, installez-la à nouveau depuis le Store.
Résumé
- Assurez-vous que les fonctionnalités WSL et Virtual Machine Platform sont activées dans Windows
- Mettre à jour Windows et le package du noyau Linux
- Vérifiez votre BIOS pour la virtualisation matérielle : activez-la
- Utilisez les commandes PowerShell pour réinitialiser ou changer les versions WSL si nécessaire
- Réinstallez ou réinitialisez votre distribution si elle ne fonctionne pas
Conclure
Faire fonctionner WSL correctement sans complications peut s’avérer complexe, surtout avec les mises à jour Windows et les problèmes matériels. Mais une fois le problème résolu, vous disposerez d’un environnement Linux puissant directement sous Windows. Parfois, un peu de patience et quelques manipulations dans le BIOS ou le terminal suffisent. Et si le système refuse toujours de coopérer, désinstaller et recommencer à zéro suffit souvent. Espérons que cela évitera à quelqu’un la même frustration que moi, car bien sûr, Windows a juste rendu les choses un peu plus compliquées qu’elles ne devraient l’être.