Comment configurer WSL sur Windows 11 : un tutoriel complet étape par étape

Installer le Sous-système Windows pour Linux (WSL) sur Windows 11 peut sembler assez simple – et ça l’est généralement – ​​mais il arrive que les choses ne se passent pas comme prévu. La commande peut ne pas s’exécuter, ou WSL peut refuser de s’activer correctement. Il se peut aussi qu’après un redémarrage, vous vous retrouviez avec un terminal Linux vide ou des erreurs étranges. C’est plutôt frustrant, car vous avez hâte de faire fonctionner votre environnement Linux sans problème, surtout si vous êtes développeur ou que vous aimez bidouiller. Ce guide vous présentera les pièges courants, comment les résoudre et des solutions concrètes pour que vous puissiez enfin utiliser votre shell Linux sous Windows 11 sans vous arracher les cheveux.

Comment résoudre les problèmes courants d’installation de WSL sous Windows 11

Assurez-vous que la virtualisation est activée dans le BIOS.

Pourquoi c’est utile : WSL 2 repose fortement sur la virtualisation ; si celle-ci est désactivée dans le BIOS, rien ne fonctionnera correctement. On oublie parfois que des paramètres du BIOS mal configurés peuvent être à l’origine du problème.

Quand cela s’applique : vous voyez des erreurs comme « Plateforme de machine virtuelle non activée » ou les commandes WSL se bloquent ou échouent silencieusement.

À quoi s’attendre : Une fois activées, les commandes wsl --installfonctionneront de manière plus fiable et l’installation devrait se dérouler sans erreurs étranges.

Vérifiez en redémarrant et en accédant au BIOS/UEFI (généralement en appuyant sur une touche comme Delete, F2ou similaire au démarrage) et recherchez les options de virtualisation, souvent nommées Intel VT-x ou AMD-V. Activez-les si elles sont désactivées, puis enregistrez et redémarrez. Sur certaines configurations, cette étape peut tout changer.

Assurez-vous que les fonctionnalités Windows pour WSL et la plateforme de machine virtuelle sont activées.

Pourquoi cela aide : Parfois, même si vous exécutez wsl --installPowerShell, les fonctionnalités Windows nécessaires ne sont pas activées, ce qui empêche WSL de fonctionner correctement ou de s’installer du tout.

Quand cela s’applique : Après l’exécution de la commande d’installation, le processus s’arrête ou se termine par des erreurs, ou vous voyez un message suggérant que des fonctionnalités sont manquantes.

À quoi s’attendre : activer manuellement ces fonctionnalités permet souvent de simplifier les choses.

Accédez à Paramètres > Applications > Fonctionnalités facultatives > Ajouter une fonctionnalité. Recherchez Sous-système Windows pour Linux et plateforme de machine virtuelle. Cochez les deux cases et cliquez sur Installer. Vous pouvez également effectuer cette opération via PowerShell en tant qu’administrateur.

DISM /Online /Enable-Feature /FeatureName:Microsoft-Windows-Subsystem-Linux /All /NoRestart DISM /Online /Enable-Feature /FeatureName:VirtualMachinePlatform /All /NoRestart

N’oubliez pas de redémarrer après l’activation.

Mettez à jour le noyau manuellement si l’installation de WSL 2 échoue systématiquement.

Pourquoi c’est utile : Il arrive que le téléchargement automatique de la mise à jour du noyau Linux ne fonctionne pas ou que la version soit obsolète. WSL 2 nécessite un noyau Linux plus récent pour fonctionner correctement.

Lorsque cela s’applique : vous obtenez des erreurs telles que « WSL 2 nécessite un noyau mis à jour » ou des commandes telles que wsl --set-default-version 2échouent.

À quoi s’attendre : L’installation ou la mise à jour manuelle du noyau résout souvent ces problèmes.

Rendez-vous sur la page officielle de mise à jour du noyau WSL2 de Microsoft et téléchargez le dernier package MSI. Exécutez-le, suivez les instructions, puis redémarrez votre ordinateur. Vous pourrez ensuite définir WSL 2 comme système par défaut sans problème.

Exécutez des commandes WSL dans PowerShell ou CMD avec des droits d’administrateur.

Pourquoi cela est utile : Parfois, les autorisations peuvent constituer un frein, notamment lors de l’installation ou de la mise à niveau de WSL.

Quand cela s’applique : des commandes comme wsl --installcelles-ci wsl --set-default-version 2génèrent des erreurs d’autorisation ou ne font tout simplement rien.

À quoi s’attendre : L’exécution de ces commandes en tant qu’administrateur débloque souvent l’accès nécessaire.

Faites un clic droit sur Démarrer et sélectionnez Terminal Windows (admin) ou exécutez PowerShell en tant qu’administrateur. Ensuite, essayez d’exécuter à nouveau vos commandes, comme :

wsl --install

Consultez le Microsoft Store pour votre distribution Linux.

Pourquoi c’est utile : Sur certaines configurations, la distribution Linux ne s’installe pas correctement ou n’est pas définie comme distribution par défaut. L’installation directe depuis le Microsoft Store facilite la gestion des distributions.

Quand cela s’applique : Après avoir activé des fonctionnalités et redémarré, l’application Linux ne se lance toujours pas, ou des erreurs concernant des fichiers manquants apparaissent.

À quoi s’attendre : installer ou supprimer des distributions depuis le Store résout souvent ces problèmes.

Ouvrez l’ application Microsoft Store, recherchez votre distribution Linux préférée (comme Ubuntu, Debian, Fedora) et appuyez sur « Obtenir ». Installez-la, puis lancez-la depuis le menu Démarrer ; vous serez alors invité à configurer votre compte utilisateur.

Redémarrez après chaque étape importante — c’est bizarre, mais ça marche

Pourquoi ça aide : Windows a parfois besoin d’un redémarrage complet pour que les modifications système soient pleinement prises en compte, notamment après l’activation de nouvelles fonctionnalités ou l’installation de noyaux. Sur une configuration, ça a fonctionné du premier coup, sur une autre… beaucoup moins. C’est assez frustrant.

Quand cela s’applique : Après avoir activé des fonctionnalités, installé des mises à jour ou modifié les paramètres du BIOS, il est important de redémarrer l’ordinateur. Même un léger délai peut avoir un impact considérable.

À quoi s’attendre : Parfois, un redémarrage rapide permet de corriger des bugs ou des configurations incomplètes qui bloqueraient votre progression.

Résumé

  • Assurez-vous que la virtualisation est activée dans le BIOS.
  • Activer les fonctionnalités WSL et de plateforme de machine virtuelle dans Windows.
  • Mettez à jour manuellement le noyau Linux si nécessaire.
  • Exécutez les commandes dans une console PowerShell ou CMD en tant qu’administrateur.
  • Gérez les distributions Linux via le Microsoft Store.
  • Redémarrez après chaque modification importante — cela peut paraître anodin, mais c’est crucial.

Conclure

Configurer WSL sous Windows 11 n’est pas toujours chose aisée, surtout si des problèmes matériels ou des mises à jour Windows viennent perturber le processus. Cependant, en suivant attentivement ces étapes, il est généralement possible de résoudre la plupart des problèmes courants. Parfois, on a l’impression que Windows complique inutilement les choses, mais la persévérance finit par payer. Une fois WSL opérationnel, l’environnement Linux offre une expérience totalement nouvelle, sans la contrainte de la machine virtuelle.

J’espère que cela permettra de résoudre ces erreurs complexes et d’accélérer votre configuration. Croisons les doigts pour que certains puissent faire fonctionner WSL sans problème et sans trop de frustration.