WSL2 (Windows Subsystem for Linux 2) vous permet d’exécuter Linux directement dans Windows, sans dual-boot ni machine virtuelle lourde. Vous conservez votre environnement Windows tout en accédant aux outils Linux (bash, Docker, Python, etc.). L’installation prend moins de 10 minutes : une seule commande suffit sur Windows 11.
Ce que vous allez apprendre
Section intitulée « Ce que vous allez apprendre »Ce guide vous accompagne dans l’installation et la configuration de WSL2 :
| Compétence | Ce que vous saurez faire |
|---|---|
| Vérifier les prérequis | Confirmer que votre PC supporte WSL2 |
| Activer la virtualisation | Configurer le BIOS si nécessaire |
| Installer WSL2 | Une commande pour tout configurer |
| Choisir une distribution | Ubuntu, Debian, Fedora… |
| Lancer des apps graphiques | Exécuter des applications Linux avec interface |
| Installation hors-ligne | Installer WSL sans connexion Internet |
Comprendre WSL2
Section intitulée « Comprendre WSL2 »L’analogie : un Linux “embarqué” dans Windows
Section intitulée « L’analogie : un Linux “embarqué” dans Windows »Imaginez WSL2 comme un appartement Linux à l’intérieur de votre maison Windows. Vous avez :
- Une entrée commune : le terminal Windows qui donne accès aux deux mondes
- Des systèmes indépendants : Linux a ses fichiers, ses processus, son réseau
- Un partage de ressources : accès aux fichiers Windows depuis Linux et inversement
Contrairement à une VM classique qui réserve CPU et RAM à l’avance, WSL2 utilise un noyau Linux léger intégré à Windows. Les ressources sont partagées dynamiquement.
WSL1 vs WSL2 : quelle différence ?
Section intitulée « WSL1 vs WSL2 : quelle différence ? »| Aspect | WSL1 | WSL2 |
|---|---|---|
| Architecture | Couche de traduction | Vrai noyau Linux |
| Performances I/O Linux | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| Performances I/O Windows | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| Compatibilité | Partielle | Complète |
| Docker | ❌ Non supporté | ✅ Natif |
| RAM utilisée | Minimale | Dynamique (2GB+) |
Recommandation : utilisez WSL2 sauf si vous travaillez intensivement sur des fichiers stockés côté Windows (dans ce cas, WSL1 peut être plus rapide pour l’accès fichiers).
Prérequis
Section intitulée « Prérequis »Version Windows requise
Section intitulée « Version Windows requise »WSL2 nécessite Windows 10 version 2004+ ou Windows 11. Pour vérifier votre version :
winverVous devez voir au minimum :
- Windows 10 : Version 2004 (Build 19041 ou supérieur)
- Windows 11 : Toutes versions supportées
Activer la virtualisation (BIOS/UEFI)
Section intitulée « Activer la virtualisation (BIOS/UEFI) »WSL2 utilise Hyper-V, qui nécessite la virtualisation matérielle. Si vous obtenez une erreur lors de l’installation, vérifiez ce paramètre.
-
Redémarrez votre PC et accédez au BIOS/UEFI
La touche dépend du fabricant (affichée au démarrage) :
-
Trouvez le paramètre de virtualisation
Le nom et l’emplacement varient selon le constructeur :
Constructeur Touche BIOS Emplacement Nom du paramètre ASUS F2 / Suppr Advanced → CPU Configuration Intel VT-x / SVM Mode Dell F2 Virtualization Support Enable Virtualization HP F10 / Échap System Configuration → Device Configuration Virtualization Technology Lenovo F1 / F2 Security → Virtualization Intel VT-x / AMD-V MSI Suppr OC → CPU Features SVM Mode / Intel VT-x Acer F2 Advanced Intel VT / AMD SVM Gigabyte Suppr M.I.T → Advanced CPU Settings SVM / VT-x Ce tableau résume les accès les plus courants. Le paramètre doit être sur Enabled.
-
Sauvegardez et redémarrez
Généralement F10 → Save & Exit.
Installation de WSL2
Section intitulée « Installation de WSL2 »Méthode standard (avec Internet)
Section intitulée « Méthode standard (avec Internet) »La méthode la plus simple, en une seule commande PowerShell administrateur :
-
Ouvrez PowerShell en administrateur
- Clic droit sur Démarrer → Terminal Windows (Admin)
- Ou : Win+X → Terminal (Admin)
-
Lancez l’installation
Fenêtre de terminal wsl --installCette commande :
- Active les fonctionnalités Windows requises
- Télécharge le noyau Linux WSL2
- Installe Ubuntu comme distribution par défaut
-
Redémarrez votre PC
Fenêtre de terminal Restart-Computer -
Configurez Ubuntu au premier lancement
Au redémarrage, Ubuntu se lance automatiquement. Créez votre utilisateur Linux :
Enter new UNIX username: votre_nomNew password: ********
Méthode hors-ligne (sans Internet)
Section intitulée « Méthode hors-ligne (sans Internet) »Pour les environnements déconnectés ou les politiques réseau restrictives.
-
Activez les fonctionnalités Windows requises
En PowerShell administrateur :
Fenêtre de terminal dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestartdism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart -
Redémarrez
Fenêtre de terminal Restart-Computer -
Téléchargez le kernel Linux
Sur un PC connecté, téléchargez : https://aka.ms/wsl2kernel
Transférez le fichier
.msiet installez-le. -
Définissez WSL2 comme version par défaut
Fenêtre de terminal wsl --set-default-version 2 -
Installez une distribution manuellement
Téléchargez le fichier
.appxdepuis le Microsoft Store (sur un PC connecté) :Distribution Lien de téléchargement Ubuntu 22.04 Microsoft Store Debian Microsoft Store Renommez le fichier
.appxen.zip, extrayez-le et lancez l’exécutable.
Commandes essentielles
Section intitulée « Commandes essentielles »Voici les commandes PowerShell indispensables pour gérer WSL au quotidien. Toutes s’exécutent depuis un terminal Windows (pas besoin d’être dans WSL).
Gérer les distributions
Section intitulée « Gérer les distributions »Une fois WSL installé, vous pouvez avoir plusieurs distributions Linux côte à côte. Ces commandes vous permettent de les lister, démarrer, arrêter ou basculer entre elles.
# Lister les distributions installéeswsl --list --verbose
# Lancer une distribution spécifiquewsl -d Ubuntu
# Définir la distribution par défautwsl --set-default Ubuntu
# Arrêter toutes les distributionswsl --shutdown
# Arrêter une distribution spécifiquewsl --terminate UbuntuGérer les versions WSL
Section intitulée « Gérer les versions WSL »Vous pouvez convertir une distribution existante de WSL1 vers WSL2 (ou inversement) sans la réinstaller. C’est utile si vous avez migré depuis une ancienne version de Windows.
# Vérifier la version de WSLwsl --version
# Convertir une distribution WSL1 → WSL2wsl --set-version Ubuntu 2
# Mettre à jour WSLwsl --updateAccéder aux fichiers
Section intitulée « Accéder aux fichiers »Les systèmes de fichiers sont accessibles des deux côtés :
| Depuis | Vers | Chemin |
|---|---|---|
| Windows | Linux | \\wsl$\Ubuntu\home\user\ |
| Linux | Windows | /mnt/c/Users/VotreNom/ |
Applications graphiques Linux
Section intitulée « Applications graphiques Linux »Depuis Windows 11, WSL2 supporte les applications graphiques Linux (WSLg) nativement.
Vérifier le support
Section intitulée « Vérifier le support »# Dans WSL2, vérifiez que DISPLAY est configuréecho $DISPLAY# Doit afficher quelque chose comme :0Installer une application graphique
Section intitulée « Installer une application graphique »# Mettre à jour les paquetssudo apt update && sudo apt upgrade -y
# Installer un éditeur graphique (exemple : gedit)sudo apt install gedit -y
# Lancer l'applicationgedit &L’application s’ouvre dans une fenêtre Windows classique, avec intégration dans la barre des tâches.
Applications courantes
Section intitulée « Applications courantes »Voici quelques applications graphiques populaires que vous pouvez installer dans WSL2. Elles s’intègrent parfaitement à Windows : icônes dans le menu Démarrer, fenêtres redimensionnables, copier-coller entre Windows et Linux.
# Navigateur de fichierssudo apt install nautilus -y
# Éditeur de code (léger)sudo apt install geany -y
# Terminal avancésudo apt install terminator -yAprès installation, lancez chaque application par son nom dans le terminal WSL (ex: nautilus &). Le & permet de garder le terminal disponible.
Configuration avancée
Section intitulée « Configuration avancée »Limiter les ressources (.wslconfig)
Section intitulée « Limiter les ressources (.wslconfig) »WSL2 peut consommer beaucoup de RAM. Créez un fichier de configuration dans votre profil Windows :
Emplacement : C:\Users\VotreNom\.wslconfig
[wsl2]memory=4GBprocessors=2swap=2GBlocalhostForwarding=trueAprès modification, redémarrez WSL :
wsl --shutdownConfiguration par distribution (wsl.conf)
Section intitulée « Configuration par distribution (wsl.conf) »Dans chaque distribution Linux, créez /etc/wsl.conf :
[boot]systemd=true
[automount]enabled=trueroot=/mnt/options="metadata,umask=22,fmask=11"
[network]generateResolvConf=trueCette configuration :
- Active systemd (services Linux)
- Configure le montage automatique des lecteurs Windows
- Génère automatiquement
/etc/resolv.conf
Intégration VS Code
Section intitulée « Intégration VS Code »VS Code s’intègre parfaitement avec WSL2 :
-
Installez l’extension Remote - WSL
Dans VS Code, installez “Remote - WSL” (ou “WSL” dans les versions récentes).
-
Ouvrez un projet WSL
Depuis WSL :
Fenêtre de terminal cd ~/mon-projetcode .Ou depuis VS Code :
Ctrl+Shift+P→ “WSL: Connect to WSL” -
Développez nativement
VS Code s’exécute côté Windows mais tous les outils (terminal, extensions) tournent dans WSL.
Dépannage
Section intitulée « Dépannage »Erreurs courantes
Section intitulée « Erreurs courantes »| Erreur | Cause probable | Solution |
|---|---|---|
| ”Virtualization disabled” | BIOS mal configuré | Activer VT-x/AMD-V dans le BIOS |
| ”WSL 2 requires an update” | Kernel obsolète | wsl --update |
| ”The requested operation requires elevation” | Droits insuffisants | Lancer PowerShell en admin |
| Distribution qui ne démarre pas | RAM insuffisante | Réduire memory dans .wslconfig |
| Réseau non disponible | VPN interférence | Désactiver le VPN ou configurer le pare-feu |
Réinitialiser une distribution
Section intitulée « Réinitialiser une distribution »Si une distribution est corrompue :
# Désinscrire (supprime les données !)wsl --unregister Ubuntu
# Réinstallerwsl --install -d UbuntuExporter/Importer une distribution
Section intitulée « Exporter/Importer une distribution »# Sauvegarderwsl --export Ubuntu D:\Backups\ubuntu.tar
# Restaurer (sur un autre PC ou après réinstallation)wsl --import Ubuntu C:\WSL\Ubuntu D:\Backups\ubuntu.tarChecklist d’installation
Section intitulée « Checklist d’installation »Utilisez cette liste pour valider que votre installation WSL2 est complète et fonctionnelle. Chaque point correspond à une étape critique du processus.
- Windows 10 2004+ ou Windows 11
- Virtualisation activée dans le BIOS
-
wsl --installexécuté avec succès - Distribution configurée (utilisateur + mot de passe)
-
wsl --list --verboseaffiche la distribution en version 2 - Accès réseau fonctionnel (
ping google.com) -
.wslconfigcréé pour limiter la RAM (optionnel)
À retenir
Section intitulée « À retenir »Ces points essentiels résument les bonnes pratiques pour utiliser WSL2 efficacement au quotidien.
| Concept | Point clé |
|---|---|
| WSL2 | Noyau Linux natif dans Windows, pas une émulation |
| Installation | wsl --install fait tout en une commande |
| Fichiers | Travaillez dans le système de fichiers natif de votre app |
| Ressources | Limitez la RAM via .wslconfig si nécessaire |
| VS Code | Extension WSL pour développer nativement |
| Sauvegarde | wsl --export avant toute manipulation risquée |
Prochaines étapes
Section intitulée « Prochaines étapes »Maintenant que WSL2 est installé, explorez ces sujets pour aller plus loin :
Architecture
┌─────────────────────────────────┐
│ Applications Linux │
├─────────────────────────────────┤
│ Noyau Linux (réel) │
├─────────────────────────────────┤
│ Machine virtuelle légère │
├─────────────────────────────────┤
│ Windows (Hyper-V) │
└─────────────────────────────────┘
Caractéristiques clés
- Noyau Linux réel : compatibilité totale avec les applications Linux
- Performances : accès rapide au système de fichiers Linux
- Intégration Windows : accès aux fichiers Windows depuis Linux et vice-versa
- Applications GUI : support des applications graphiques Linux sous Windows 11
Cas d'usage
Comparaison
| Aspect | WSL 1 | WSL 2 |
|---|---|---|
| Architecture | Couche de traduction (syscalls) | Vrai noyau Linux dans VM légère |
| Compatibilité | ~80% des appels système | 100% compatibilité Linux |
| Performances FS Linux | Lent | Rapide (natif) |
| Performances FS Windows | Rapide | Plus lent (9p protocole) |
| Mémoire | Partagée avec Windows | VM avec allocation dynamique |
| Docker | Non supporté | Supporté nativement |
| Applications GUI | Non | Oui (Windows 11) |
Quand choisir WSL 1 ?
- Projets stockés sur le disque Windows (
/mnt/c/) - Ressources mémoire limitées
Quand choisir WSL 2 ? (recommandé)
- Développement Linux : compilation, tests
- Conteneurs : Docker, Podman
- Applications GUI : VS Code Remote, GIMP
- Compatibilité maximale : tous les outils Linux
Commande pour changer de version
# Passer une distribution en WSL 2
wsl --set-version Ubuntu 2
# Définir WSL 2 par défaut
wsl --set-default-version 2
Méthode 1 : Gestionnaire des tâches (simple)
- Ouvrir avec Ctrl + Shift + Esc
- Onglet Performances → Processeur
- Chercher la ligne Virtualisation
| Valeur | Signification |
|---|---|
| Activée | ✅ Prêt pour WSL 2 |
| Désactivée | ❌ Activer dans le BIOS |
Méthode 2 : PowerShell (détaillée)
# Vérifier le support Hyper-V
Get-ComputerInfo | Select-Object HyperV*
# Résultat attendu
HyperVisorPresent : True
HyperVRequirementVirtualizationFirmwareEnabled : True
Méthode 3 : Commande systeminfo
systeminfo | Select-String "Hyper-V"
# Résultat attendu : toutes les lignes à "Oui"
Configuration requise pour Hyper-V: Oui
Si la virtualisation est désactivée
Vous devez l'activer dans le BIOS/UEFI de votre machine (voir question suivante).Étape 1 : Accéder au BIOS/UEFI
| Marque | Touche(s) au démarrage |
|---|---|
| ASUS | F2 ou DEL |
| Acer | F2 ou DEL |
| Dell | F2 ou F12 |
| HP | ESC ou F10 |
| Lenovo | F2 ou F1 (ThinkPad: Entrée + F1) |
| MSI | DEL |
| Samsung | F2 |
Étape 2 : Trouver l'option virtualisation
| Processeur | Nom de l'option |
|---|---|
| Intel | Intel Virtualization Technology (VT-x) |
| AMD | AMD-V ou SVM Mode |
Advanced Settings→CPU ConfigurationSecurity→VirtualizationBIOS Features→Intel VT-x
Étape 3 : Activer et sauvegarder
- Changer la valeur sur Enabled
- Appuyer sur F10 (Save & Exit)
- Redémarrer le PC
Vérification après redémarrage
# Doit retourner "Activée"
(Get-CimInstance Win32_Processor).VirtualizationFirmwareEnabled
Installation rapide (recommandée)
# Ouvrir PowerShell en Administrateur
# Installer WSL + Ubuntu par défaut
wsl --install
Cette commande :- Active les fonctionnalités Windows nécessaires
- Télécharge le noyau Linux WSL 2
- Installe Ubuntu depuis Microsoft Store
Choisir une autre distribution
# Lister les distributions disponibles
wsl --list --online
# Installer une distribution spécifique
wsl --install -d Debian
wsl --install -d kali-linux
wsl --install -d Ubuntu-22.04
Distributions populaires
| Distribution | Commande | Usage |
|---|---|---|
| Ubuntu | wsl --install -d Ubuntu |
Général, développement |
| Debian | wsl --install -d Debian |
Serveurs, stabilité |
| Kali Linux | wsl --install -d kali-linux |
Sécurité, pentesting |
| Arch Linux | Installation manuelle | Utilisateurs avancés |
| AlmaLinux | wsl --install -d AlmaLinux-9 |
Alternative RHEL |
Après l'installation
# Premier lancement : créer un utilisateur
wsl
# Entrer un nom d'utilisateur et mot de passe
# Mettre à jour les paquets
sudo apt update && sudo apt upgrade -y
Étape 1 : Activer les fonctionnalités Windows
# PowerShell en Administrateur
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
# Redémarrer obligatoire
Restart-Computer
Étape 2 : Installer le noyau WSL 2
Télécharger depuis : aka.ms/wsl2kernel# Après téléchargement
msiexec /i wsl_update_x64.msi /quiet
Étape 3 : Définir WSL 2 par défaut
wsl --set-default-version 2
Étape 4 : Télécharger une distribution manuellement
Depuis Microsoft Learn :| Distribution | Fichier |
|---|---|
| Ubuntu 22.04 | Ubuntu2204-221101.AppxBundle |
| Debian | DebianGNULinux.appx |
Étape 5 : Installer la distribution
# Copier le fichier .appx sur la machine cible
Add-AppxPackage -Path .\Ubuntu2204.appx
# Lancer la distribution
ubuntu2204.exe
Vérification
wsl --list --verbose
# NAME STATE VERSION
# Ubuntu-22.04 Running 2
.wslconfig permet de configurer les ressources allouées à WSL 2 (mémoire, CPU, swap).Emplacement du fichier
C:\Users\<VotreNom>\.wslconfig
Configuration recommandée
[wsl2]
# Limiter la mémoire (par défaut: 50% de la RAM)
memory=8GB
# Limiter les processeurs (par défaut: tous)
processors=4
# Taille du swap
swap=4GB
# Libérer la mémoire inutilisée
pageReporting=true
# Désactiver la récupération automatique de mémoire
# autoMemoryReclaim=gradual # dropin, gradual, disabled
# Réseau
networkingMode=mirrored # NAT ou mirrored (Windows 11)
# DNS
dnsTunneling=true
[experimental]
autoMemoryReclaim=gradual
sparseVhd=true
Options importantes
| Option | Description | Défaut |
|---|---|---|
memory |
RAM maximale pour WSL 2 | 50% de la RAM |
processors |
Nombre de CPU virtuels | Tous |
swap |
Taille du fichier swap | 25% de la RAM |
localhostForwarding |
Accès localhost Windows → WSL | true |
nestedVirtualization |
VM dans WSL (Docker) | true |
Appliquer les changements
# Arrêter WSL pour appliquer
wsl --shutdown
# Relancer
wsl
Interface graphique (Windows 11)
Depuis 2024, une application graphique permet de configurer WSL sans éditer le fichier manuellement :# Ouvrir les paramètres WSL
wsl --manage
Prérequis
| Élément | Requis |
|---|---|
| Windows | Windows 11 (build 22000+) ou Windows 10 22H2 |
| WSL | Version récente (wsl --update) |
| GPU Driver | Intel/AMD/NVIDIA compatible |
Vérifier le support
# Mettre à jour WSL
wsl --update
# Vérifier la version
wsl --version
# WSLg version doit apparaître
Installer une application GUI
# Mettre à jour les paquets
sudo apt update
# Installer des applications graphiques
sudo apt install -y gimp # Éditeur d'images
sudo apt install -y firefox # Navigateur
sudo apt install -y nautilus # Gestionnaire de fichiers
sudo apt install -y gedit # Éditeur de texte
Lancer une application
# Depuis le terminal WSL
gimp &
firefox &
# Depuis Windows (Run dialog)
wsl gimp
Applications populaires pour WSL
| Application | Installation | Usage |
|---|---|---|
| VS Code | code . (Remote-WSL) |
Développement |
| GIMP | apt install gimp |
Retouche image |
| Firefox | apt install firefox |
Navigation web |
| VLC | apt install vlc |
Lecture multimédia |
| LibreOffice | apt install libreoffice |
Suite bureautique |
Dépannage
Si les applications GUI ne s'affichent pas :# Vérifier DISPLAY
echo $DISPLAY
# Doit retourner :0 ou similaire
# Mettre à jour le pilote GPU
# Télécharger depuis le site du fabricant (Intel/AMD/NVIDIA)
Installation recommandée
- Installer Docker Desktop depuis docker.com
- Dans Settings → General : activer Use WSL 2 based engine
- Dans Settings → Resources → WSL Integration : activer vos distributions
Vérification
# Depuis WSL
docker --version
docker run hello-world
Alternative : Docker Engine natif dans WSL
Pour éviter Docker Desktop (licence) :# Installer Docker Engine dans Ubuntu WSL
curl -fsSL https://get.docker.com | sh
# Ajouter l'utilisateur au groupe docker
sudo usermod -aG docker $USER
# Démarrer le service
sudo service docker start
# Rendre le démarrage automatique
echo 'sudo service docker start' >> ~/.bashrc
Performances optimales
| Conseil | Explication |
|---|---|
| Stocker les projets dans WSL | /home/user/projets/ pas /mnt/c/ |
| Utiliser des volumes nommés | Éviter les bind mounts vers Windows |
| Allouer assez de RAM | .wslconfig avec memory=8GB minimum |
Exemple docker-compose dans WSL
# Se placer dans le dossier Linux (pas /mnt/c/)
cd ~/projets/mon-app
# Lancer les services
docker compose up -d
# Accéder depuis Windows
# http://localhost:3000 (port forwarding automatique)
Accéder à Windows depuis WSL
# Les disques Windows sont montés dans /mnt/
ls /mnt/c/Users/
cd /mnt/c/Users/MonNom/Documents
# Exemple : copier un fichier
cp /mnt/c/Users/MonNom/fichier.txt ~/
Accéder à WSL depuis Windows
# Via l'explorateur de fichiers
\\wsl$\Ubuntu\home\monuser
# Ou depuis la barre d'adresse
\\wsl.localhost\Ubuntu
Bonnes pratiques de performance
| Situation | Recommandation |
|---|---|
| Projet de dev Linux | Stocker dans ~/projets/ (WSL natif) |
| Fichiers partagés | Utiliser /mnt/c/ ponctuellement |
| Git clone | Toujours cloner côté Linux |
| npm/pip install | Exécuter depuis le FS Linux |
Ouvrir VSCode depuis WSL
# Se placer dans le dossier du projet
cd ~/projets/mon-app
# Ouvrir VS Code avec Remote-WSL
code .
Copier entre systèmes
# Windows → WSL
cp /mnt/c/Users/MonNom/Downloads/fichier.zip ~/
# WSL → Windows
cp ~/rapport.pdf /mnt/c/Users/MonNom/Documents/
# Avec explorateur Windows
explorer.exe . # Ouvre le dossier courant dans l'explorateur
Performances
┌─────────────────────────────────────────┐
│ Performance d'accès aux fichiers │
├─────────────────────────────────────────┤
│ WSL FS (ext4) ████████████████ 100% │
│ Windows → WSL ████████ 50% │
│ WSL → Windows ██████ 35% │
└─────────────────────────────────────────┘
Règle d'or : gardez vos projets dans le système de fichiers où vous travaillez le plus.Erreur : "WSL 2 requires an update to its kernel component"
# Télécharger et installer la mise à jour du noyau
# https://aka.ms/wsl2kernel
wsl --update
Erreur : "The virtual machine could not be started"
# Vérifier que Hyper-V est activé
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all
# Redémarrer
Restart-Computer
WSL consomme trop de mémoire
# Créer/modifier C:\Users\<Nom>\.wslconfig
[wsl2]
memory=4GB
swap=2GB
[experimental]
autoMemoryReclaim=gradual
# Appliquer les changements
wsl --shutdown
Internet ne fonctionne pas dans WSL
# Vérifier le DNS
cat /etc/resolv.conf
# Corriger manuellement si nécessaire
sudo rm /etc/resolv.conf
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf
sudo chattr +i /etc/resolv.conf # Empêcher la réécriture
Réinitialiser une distribution
# Exporter les données importantes d'abord
wsl --export Ubuntu ubuntu-backup.tar
# Désinstaller
wsl --unregister Ubuntu
# Réinstaller
wsl --install -d Ubuntu
# Restaurer si besoin
wsl --import Ubuntu C:\WSL\Ubuntu ubuntu-backup.tar
Commandes de diagnostic
# État de WSL
wsl --status
# Lister les distributions
wsl --list --verbose
# Arrêter toutes les instances
wsl --shutdown
# Mettre à jour WSL
wsl --update
# Vérifier la version
wsl --version
Tableau de diagnostic
| Symptôme | Cause probable | Solution |
|---|---|---|
| Lenteur extrême | Fichiers sur /mnt/c | Déplacer vers ~/ |
| Pas de réseau | DNS mal configuré | Modifier resolv.conf |
| RAM saturée | Pas de limite | Configurer .wslconfig |
| Erreur au démarrage | Virtualisation désactivée | Activer dans BIOS |