Si vous travaillez dans le développement logiciel, l'administration système ou si vous aimez simplement bidouiller avec Linux, WSL2 est devenu un outil quasi indispensable sous Windows . Il vous permet de disposer d'un environnement GNU/Linux complet, avec un véritable noyau, directement intégré à votre ordinateur, sans avoir à vous soucier de machines virtuelles complexes ou de configurations à double démarrage.
Dans ce guide, nous verrons comment installer et configurer WSL2 étape par étape sous Windows 10 et Windows 11 , les exigences à respecter, comment choisir la meilleure distribution Linux pour vos besoins, comment gérer plusieurs distributions et quelles sont les bonnes pratiques à suivre pour en tirer le meilleur parti et éviter les erreurs courantes lors de l'installation.
Qu'est-ce que WSL et quels sont les avantages de WSL2 ?
WSL (Windows Subsystem for Linux) est une fonctionnalité de Windows qui vous permet d'exécuter des distributions GNU/Linux telles qu'Ubuntu, Debian, Kali ou Alpine directement sous Windows , en utilisant leurs outils et commandes habituels (bash, ssh, git, grep, etc.) sans avoir besoin d'une machine virtuelle traditionnelle.
Avec l'arrivée de WSL2, Microsoft a franchi une étape importante, passant d'une simple couche de compatibilité à l'exécution d'un véritable noyau Linux au sein d'une machine virtuelle légère . Il en a résulté une amélioration considérable des performances du système de fichiers et du réseau, ainsi qu'une compatibilité quasi totale avec les appels système Linux.
Parmi les avantages les plus intéressants de WSL2 figurent un accès disque et réseau beaucoup plus rapide, une utilisation optimisée de la mémoire et une intégration très pratique entre les fichiers Windows et Linux , vous permettant de travailler sur les mêmes projets depuis les deux environnements sans aucun problème.
Pour les environnements de développement modernes, WSL2 est idéal car il s'intègre parfaitement aux flux de travail basés sur les conteneurs Docker, à l'intégration continue et à la livraison continue (CI/CD), au développement web et à la science des données , permettant à votre environnement d'ordinateur portable de ressembler étroitement à vos serveurs de production (qui sont généralement sous Linux).
Prérequis pour l'installation de WSL2
Avant de vous lancer dans l'exécution frénétique de commandes, il est conseillé de vérifier que votre version de Windows est compatible avec WSL2 et que la virtualisation est activée dans le BIOS , car sinon vous risquez de rencontrer des erreurs assez déroutantes.
Selon le système d'exploitation, WSL2 est disponible sur Windows 10 et Windows 11 , mais avec des versions minimales assez spécifiques. Sur Windows 10, la version 1903 (build 18362) est requise pour les fonctionnalités de base de WSL, et pour profiter pleinement de WSL2, la version 2004 (build 19041) ou une version ultérieure est recommandée. Sur Windows 11, la quasi-totalité des éditions récentes intègrent WSL2 par défaut.
Pour vérifier votre version exacte, appuyez sur Win+R, saisissez « winver » et appuyez sur OK . Une petite fenêtre s'ouvrira affichant votre édition, votre version et votre build de Windows. Si l'une de ces informations est manquante, vous devrez mettre à jour Windows via Paramètres > Mise à jour et sécurité.
Outre la version de Windows, la virtualisation matérielle doit être activée dans le BIOS/UEFI de votre ordinateur . Dans le cas contraire, WSL2 ne pourra pas démarrer et vous verrez des erreurs telles que 0x80370102 ou des messages concernant Hyper-V. L'option peut porter différents noms selon le fabricant (Intel VT-x, Intel Virtualization Technology, AMD-V, SVM, etc.), mais le principe reste le même : accédez au BIOS, repérez la section relative au processeur ou à la sécurité et activez la virtualisation.
Autre détail important : WSL2 n’est pas pris en charge par Windows 10 S et des limitations peuvent exister dans certaines éditions LTSC ou sur Windows Server avec des stratégies d’entreprise . Dans ces cas, il est souvent nécessaire d’installer manuellement les distributions à l’aide de fichiers appx ou tar plutôt que depuis le Microsoft Store.
Méthode rapide : installer WSL2 en une seule commande
Dans les versions modernes de Windows, Microsoft a considérablement simplifié le processus, à tel point qu'il est possible d'avoir WSL et une distribution Linux fonctionnelle avec une seule commande , sans avoir à cocher aucune case dans les fonctionnalités Windows.
La méthode recommandée consiste à ouvrir PowerShell ou l'invite de commandes en tant qu'administrateur (cliquez avec le bouton droit sur l'icône et sélectionnez « Exécuter en tant qu'administrateur ») et à exécuter :
wsl --install
Cette commande active automatiquement les fonctionnalités nécessaires du sous-système Windows pour Linux et de la plateforme de machine virtuelle , télécharge le noyau Linux pour WSL2 et installe par défaut Ubuntu comme distribution Linux initiale sur votre système.
Une fois le processus terminé, Windows vous invitera à redémarrer. Après ce premier redémarrage, lors de la première ouverture de votre distribution Linux, un message d'installation et de création d'utilisateur s'affichera pendant l'extraction des fichiers et la préparation de l'environnement. Ce premier lancement peut prendre un peu de temps, mais les lancements suivants sont quasi instantanés.
Si vous préférez utiliser une distribution différente d'Ubuntu dès le départ, vous pouvez le spécifier avec le paramètre -d . Par exemple, pour installer Debian directement :
wsl --install -d Debian
Vous pouvez consulter à tout moment la liste des distributions officielles disponibles pour l'installation avec :
wsl --list --online
Installation manuelle étape par étape de WSL2
La commande rapide est très pratique, mais sur les machines équipées d'anciennes versions de Windows 10, sur Windows Server ou en cas de politiques d'entreprise restrictives , vous devrez peut-être suivre la procédure manuelle traditionnelle étape par étape.
La première étape consiste à activer la fonctionnalité optionnelle « Sous-système Windows pour Linux » . Pour ce faire, ouvrez PowerShell en tant qu’administrateur et exécutez :
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
Cette opération prépare votre système à exécuter WSL de base (WSL1). Si vous souhaitez uniquement cette version, vous pouvez redémarrer maintenant et procéder directement à l'installation d'une distribution. Toutefois, pour utiliser WSL2, il est préférable de suivre ces étapes avant ou immédiatement après le redémarrage.
La deuxième étape consiste à activer la fonctionnalité « Plateforme de machine virtuelle » , qui constitue la base sur laquelle s'exécute le noyau Linux WSL2. Là encore, dans PowerShell en tant qu'administrateur, exécutez :
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Après avoir activé ces deux fonctionnalités, redémarrez votre ordinateur afin que Windows puisse appliquer les modifications . Cette étape est cruciale, car sans redémarrage, vous risquez de rencontrer des erreurs étranges lors de l'utilisation de WSL.
Une fois le système redémarré, vous devez installer ou mettre à jour le noyau Linux pour WSL . Microsoft propose un programme d'installation MSI qui télécharge la dernière version du noyau. Vous pouvez le télécharger depuis la page GitHub officielle de WSL ou depuis la documentation Microsoft, puis l'exécuter comme n'importe quel autre programme d'installation, en acceptant les privilèges d'administrateur lorsque cela vous est demandé.
Une fois le paquet noyau installé, il est conseillé de définir WSL2 comme version par défaut pour toutes les nouvelles distributions que vous installez . Vous pouvez le faire avec la commande suivante dans PowerShell ou CMD :
wsl --set-default-version 2
À partir de ce moment, chaque nouvelle distribution sera créée directement dans WSL2 , bien que vous puissiez toujours forcer ultérieurement une distribution spécifique à utiliser WSL1 ou WSL2 avec la commande de changement de version.
Installez une distribution Linux pour WSL2
Une fois WSL activé et WSL2 défini comme système par défaut, l'étape suivante consiste à choisir et installer votre distribution GNU/Linux préférée . Voici plusieurs options selon que vous puissiez utiliser le Microsoft Store ou que vous deviez l'installer manuellement.
Dans le cas le plus simple, ouvrez le Microsoft Store et recherchez « Linux » ou directement la distribution souhaitée : Ubuntu, Debian, Kali Linux, Fedora, Arch, openSUSE, Alpine, Oracle Linux, Rocky, AlmaLinux, etc. Chacune possède sa propre page et s’installe avec le bouton « Obtenir », comme n’importe quelle autre application.
Cliquer sur « Obtenir » téléchargera les fichiers depuis la boutique. Une fois l'installation terminée, le bouton « Démarrer » apparaîtra . Lors de la première ouverture, une console s'affichera avec un processus d'installation interne, puis vous serez invité à créer un nom d'utilisateur et un mot de passe pour ce système Linux.
Si vous ne pouvez pas utiliser le Microsoft Store (par exemple, sur Windows Server, les versions LTSC ou les ordinateurs dont la politique de sécurité bloque l'accès au Microsoft Store ), vous pouvez également télécharger les packages .appx des distributions directement depuis les liens officiels de Microsoft. Ces packages s'installent avec la commande :
Add-AppxPackage .\nombre_de_la_distro.appx
Une autre solution, très utile lorsque Microsoft fournit des URL directes, consiste à utiliser curl.exe ou Invoke-WebRequest pour télécharger le package depuis PowerShell . Par exemple, vous pouvez procéder comme suit :
Invoke-WebRequest -Uri https://aka.ms/wslubuntu2204 -OutFile Ubuntu.appx -UseBasicParsing
Une fois le paquet appx téléchargé et installé, il suffit de double-cliquer sur le fichier ou de lancer la distribution depuis le menu Démarrer pour terminer la configuration et créer votre utilisateur Linux.
Premier démarrage : créer un utilisateur et configurer la distribution
Lors du premier démarrage d'une distribution nouvellement installée, WSL affiche un message expliquant qu'il installe le système et que cela peut prendre quelques minutes . C'est normal ; il décompresse le système de fichiers racine et prépare l'environnement.
Une fois terminé, vous verrez une notification comme celle-ci :
Installing, this may take a few minutes...
Please create a default UNIX user account.
Enter new UNIX username:
À ce stade, vous devrez choisir un nom d'utilisateur pour votre compte Linux, qui sera l'utilisateur par défaut avec lequel vous vous connecterez à cette distribution et qui disposera généralement des permissions sudo.
Il est conseillé que le nom d'utilisateur être en minuscules, sans accents ni caractères spéciauxEt il n'est pas nécessaire qu'il corresponde à votre nom d'utilisateur Windows. Ce même nom sera utilisé pour votre dossier personnel, par exemple. /home/manuel si vous avez choisi « manuel ».
Ensuite, le système vous demandera de saisir un mot de passe pour cet utilisateur et de le confirmer . Il est essentiel de mémoriser ces identifiants, car vous les utiliserez pour les opérations avec sudo et pour accéder à l'environnement si vous activez des services supplémentaires.
Une fois l'utilisateur créé, votre distribution GNU/Linux sera pleinement fonctionnelle et exécutée sous Windows . Vous pourrez alors mettre à jour les paquets avec apt, dnf ou pacman, selon la distribution, et installer des outils de développement, des serveurs web, des bases de données, etc.
Commandes de base pour la gestion de WSL et WSL2
WSL se gère principalement à l'aide de la commande wsl.exe depuis PowerShell ou l'invite de commandes . Il existe plusieurs commandes que vous devriez connaître pour savoir ce qui est installé et quelle version de chaque distribution utilise.
Pour lister les distributions disponibles et afficher leur statut et leur version, vous pouvez utiliser le paramètre -l -v (ou la forme longue –list –verbose) :
wsl -l -v
Dans le résultat, vous verrez des colonnes indiquant le nom de la distribution, son état (en cours d'exécution ou arrêté) et sa version (1 ou 2). Si vous avez effectué une migration depuis WSL1, vous pourrez vérifier ici si la conversion a été correctement appliquée.
Si vous souhaitez modifier la version WSL d'une distribution spécifique, utilisez la commande --set-version en spécifiant la distribution et la version 1 ou 2 :
wsl --set-version Ubuntu 2
Cela lancera un processus de conversion qui peut prendre un certain temps selon la taille du système de fichiers de votre distribution. Cela prend généralement plusieurs minutes, alors soyez patient. Une fois la conversion terminée, si vous relancez le processus… wsl -l -vVous devriez voir la colonne VERSION avec un 2.
Vous pouvez également définir la version par défaut pour les nouvelles installations avec `--set-default-version` , comme nous l'avons vu précédemment :
wsl --set-default-version 2
Pour sélectionner la distribution qui sera utilisée par défaut lorsque vous saisissez uniquement du texte wsl sans paramètres, Utilisez la commande –set-default ou son alias -s indiquant le nom de la distribution :
wsl --set-default Debian
Si à un moment donné vous avez besoin de démarrer une distribution spécifique sans modifier la distribution par défaut, vous pouvez utiliser le paramètre -d :
wsl -d Kali-Linux
Pour exécuter une commande Linux spécifique depuis PowerShell ou CMD sans ouvrir de session interactive , procédez simplement comme suit :
wsl ls -la
Cela exécutera ls -la dans la distribution par défaut et renverra la sortie directement à votre terminal Windows, ce qui est très pratique pour les petits scripts ou les tâches automatisées.
Choisir, installer et gérer plusieurs distributions dans WSL2
L'un des grands avantages de WSL est qu'il n'est pas limité à une seule distribution . Vous pouvez en installer autant que vous le souhaitez et les utiliser pour différents projets ou tests sans qu'elles n'interfèrent entre elles.
L'approche la plus courante consiste à utiliser Ubuntu ou Debian comme base pour le développement général , mais vous pouvez ajouter Kali pour des raisons de sécurité, AlmaLinux ou Rocky pour simuler des environnements de type RHEL, openSUSE pour essayer une philosophie différente, ou des distributions minimalistes comme Alpine pour les conteneurs.
Pour voir quelles options d'installation rapide sont actuellement disponibles, utilisez la commande qui liste les distributions en ligne :
wsl --list --online
Le résultat affichera les noms des distributions prêtes à être utilisées avec wsl --install -d NombreDistroSi vous choisissez une application payante sur le Microsoft Store, un avertissement s'affichera, mais beaucoup d'entre elles proposent également des fonctionnalités supplémentaires. chaînes de téléchargement gratuites alternatives en dehors du magasin.
Une fois que vous avez installé plusieurs distributions, Vous pouvez définir celle que vous utilisez le plus souvent comme commande par défaut pour vos commandes quotidiennes. et démarrer le reste depuis le Terminal Windows, depuis le menu Démarrer (en recherchant « Ubuntu », « Debian », etc.) ou avec wsl -d quand vous avez besoin de quelque chose de spécifique.
Si l'une des distributions devient inutile ou si vous ne la souhaitez que pour un test spécifique, vous pouvez la désinstaller via Applications et fonctionnalités Windows ou à l'aide de la commande de désinscription (qui supprime l'intégralité de la distribution et ses données). Ainsi, votre système reste propre et exempt d'environnements inutilisés.
Intégration avec Docker, VS Code et les flux de travail de développement
C’est là que WSL2 révèle tout son potentiel : lorsqu’on l’intègre à son flux de travail de développement quotidien avec des outils modernes , notamment Docker et Visual Studio Code.
Dans le cas de Docker, Docker Desktop pour Windows permet d'utiliser WSL2 comme backend , au lieu du classique Hyper-V. Cela améliore considérablement les performances des conteneurs et simplifie la gestion des images et des volumes, puisqu'ils s'exécutent directement au sein de la même distribution Linux que celle utilisée pour le développement.
Pour les éditeurs de code, Visual Studio Code propose l' extension Remote – WSL , qui permet d'ouvrir un dossier de votre distribution Linux comme si vous y travailliez nativement. Concrètement, cela signifie que l'analyse de code, le débogage, le terminal intégré et les autres outils s'exécutent dans WSL2 , tandis que l'éditeur graphique s'exécute sous Windows.
Cette combinaison facilite grandement le travail avec les microservices, les API, les projets Node.js, Python, Go ou Ruby, les applications Docker et les déploiements cloud (AWS, Azure, etc.), car vous testez vos applications presque exactement de la même manière que sur un véritable serveur Linux.
Dans les environnements professionnels ou d'entreprise, les équipes spécialisées dans les logiciels personnalisés, la cybersécurité ou les services cloud utilisent WSL2 pour créer des pipelines d'intégration et de déploiement continus, automatiser les tests et travailler avec des agents d'intelligence artificielle ou des outils d'analyse de données sans quitter leur poste de travail Windows.
Accès et partage de fichiers entre Windows et Linux
L'un des atouts de WSL est que les systèmes de fichiers Windows et Linux sont intégrés de manière très transparente , ce qui vous permet de transférer des projets d'un système à l'autre sans trop de difficultés.
Depuis Linux, Vos lecteurs Windows sont automatiquement montés sous le chemin /mntPar exemple, le lecteur C ressemblera à ceci : /mnt/c, le D comme /mnt/det ainsi de suite. Si vous entrez dans /mnt/c/Users/TuUsuario Vous pourrez manipuler vos documents, répertoires et fichiers Windows depuis le terminal Linux.
Inversement, vous pouvez également le faire depuis l'Explorateur de fichiers Windows. accéder nativement aux fichiers de votre distribution LinuxWindows crée des chemins d'accès et des variables d'environnement spécifiques pour accéder à votre /homeDe plus, avec WSL2, il est possible de naviguer dans le navigateur en utilisant des chemins réseau spéciaux qui pointent vers le système de fichiers de la distribution.
Cela dit, en termes de performance, Il est recommandé que les projets de développement résident dans le système de fichiers de la distribution Linux elle-même. (par exemple, /home/tuusuario/proyecto) et non dans /mnt/ccar l'accès via le système de fichiers Windows est généralement beaucoup plus lent, surtout si vous effectuez de nombreuses petites opérations.
Cette intégration de fichiers est particulièrement utile lorsque vous souhaitez modifier des documents avec des applications graphiques Windows et exécuter des scripts ou des commandes sur ces mêmes fichiers depuis Linux , sans avoir à dupliquer le contenu ni à créer de mécanismes de synchronisation complexes.
Bonnes pratiques, performances et sécurité dans WSL2
Une fois que WSL2 et une ou plusieurs distributions sont opérationnels, il est conseillé d'appliquer une série de bonnes pratiques pour maintenir un environnement stable, sécurisé et performant , surtout si vous prévoyez une utilisation intensive.
Tout d'abord, assurez-vous que le noyau WSL et les distributions elles-mêmes sont à jour . Vous pouvez mettre à jour le composant WSL depuis Windows avec :
wsl --update
Ensuite, au sein de la distribution, utilisez le gestionnaire de paquets correspondant (apt update && apt upgrade, dnf upgradeetc.) pour s'assurer que tous les logiciels sont à jour et que les correctifs de sécurité sont appliqués.
Du point de vue de la sécurité, bien que WSL2 s'exécute dans une machine virtuelle légère, il s'agit toujours d'un environnement Linux comportant des services, des ports et des processus susceptibles de présenter des vulnérabilités . Il est donc important d'utiliser un compte utilisateur non root pour les opérations courantes, de configurer des pare-feu si vous exposez des services et d'éviter de laisser des processus en écoute sur toutes les interfaces sans contrôle.
Pour les équipements couramment utilisés dans le développement intensif, la science des données ou les conteneurs, vous pourriez être intéressé par : Ajuster la consommation de ressources de WSL2 (mémoire, processeur, swap) en utilisant le fichier de configuration .wslconfig Sous Windows, vous pouvez limiter la quantité de RAM et le nombre de cœurs que la machine virtuelle WSL peut utiliser.
Concernant les performances du système de fichiers, Il est préférable de travailler dans le stockage natif de la distribution. Pour les projets de grande envergure et les dépôts de code. Accès aux dossiers Windows sous /mnt Il fonctionne bien pour des tâches spécifiques, mais dans des scénarios comportant des millions de fichiers ou de nombreuses opérations d'E/S, il peut être considérablement plus lent que WSL1.
Et, même si cela peut paraître évident, il est bon de rappeler qu'avant d'effectuer des modifications importantes ou des tests risqués, il est conseillé de sauvegarder vos données les plus importantes , surtout si vous comptez utiliser des scripts, des conteneurs ou des outils de bas niveau dans l'environnement Linux.
Erreurs courantes lors de l'installation de WSL2 et comment les corriger
Lors de l'installation ou de la configuration de WSL2, vous pourriez rencontrer des erreurs courantes fréquemment rencontrées par les utilisateurs . Les connaître à l'avance vous permettra d'économiser du temps et d'éviter des frustrations.
L'une des erreurs les plus fréquentes est l'erreur 0x8007019e , qui indique généralement que le sous-système WSL n'est pas correctement activé. Pour la résoudre, il faut relancer la commande d'activation de la fonctionnalité WSL à l'aide de DISM ou via « Activer ou désactiver des fonctionnalités Windows », puis redémarrer l'ordinateur.
Un autre problème courant consiste à afficher un message indiquant que WSL2 nécessite une mise à jour d'un composant du noyau . Ce problème est généralement résolu en téléchargeant le dernier package de mise à jour du noyau Linux pour WSL depuis le site web de Microsoft et en l'installant manuellement.
Les erreurs 0x80370102 et 0x80070003 peuvent être liées à une virtualisation désactivée ou mal configurée , ou au fait que le stockage par défaut de Windows se trouve sur un autre disque. Dans le premier cas, vous devrez accéder au BIOS et activer la virtualisation ; dans le second, vérifiez dans Paramètres > Système > Stockage où les nouvelles applications sont enregistrées et modifiez-le si nécessaire.
Lorsqu'une installation de distribution ne se termine pas correctement, il est conseillé de consulter le guide de dépannage officiel de WSL , où Microsoft détaille bon nombre de ces codes d'erreur et propose des étapes spécifiques pour les résoudre, y compris des cas particuliers pour les installations Windows Server ou Core.
Si votre problème vient de la commande wsl --install Il n'existe pas ou il est défectueux, il est probable que Votre version de Windows est peut-être trop ancienne pour prendre en charge cette méthode simplifiée.Vous devrez donc suivre la procédure d'installation manuelle en activant WSL et la plateforme de machine virtuelle, en installant le noyau, puis en ajoutant les distributions une par une.
En général, passer un peu de temps à examiner les exigences de version, la virtualisation et les fonctionnalités activées permet généralement de résoudre la plupart des erreurs sans avoir recours à des mesures drastiques , et une fois que WSL2 démarre correctement, son comportement est assez stable.
WSL2 s'est imposé comme une solution très puissante pour ceux qui ont besoin de combiner les mondes Windows et Linux sur une même machine. Grâce aux étapes et recommandations ci-dessus, vous devriez pouvoir l'installer, le configurer et l'utiliser quotidiennement en toute simplicité, en profitant de ses avantages en termes de performance, de compatibilité et de productivité, sans rencontrer les problèmes typiques des machines virtuelles traditionnelles.