Un guide pas à pas des bonnes pratiques de configuration d’un environnement de développement WSL. Découvrez comment exécuter la commande pour installer l’interpréteur de commandes Bash par défaut qui utilise Ubuntu ou qui peut être configuré pour installer d’autres distributions Linux, utiliser des commandes WSL de base, configurer Visual Studio Code ou Visual Studio, Git, le Gestionnaire d’informations d’identification Windows, des bases de données comme MongoDB, Postgres ou MySQL, configurer l’accélération de GPU, exécuter des applications de GUI et plus encore.
Prise en main
Le Sous-système Windows pour Linux est fourni avec le système d’exploitation Windows, mais vous devez l’activer et installer une distribution Linux avant de pouvoir commencer à l’utiliser.
Pour utiliser la commande simplifiée --install, vous devez exécuter un build récent de Windows (build 20262+). Pour vérifier votre numéro de version et de build, sélectionnez la touche Windows + R, tapez winver et sélectionnez OK. Vous pouvez effectuer la mise à jour avec le menu des Paramètres ou l’Assistant Mise à jour Windows.
Si vous préférez installer une autre distribution Linux qu’Ubuntu, ou si vous préférez effectuer ces étapes manuellement, consultez la page d’installation de WSL pour plus d’informations.
Ouvrez PowerShell (ou l’invite de commandes Windows) et entrez :
wsl --install
La commande --install effectue les actions suivantes :
Active les composants facultatifs de WSL et de la plateforme de machine virtuelle
Télécharge et installe le dernier noyau Linux
Définit WSL 2 comme valeur par défaut
Télécharge et installe la distribution Linux Ubuntu (un redémarrage peut être nécessaire)
Vous devez redémarrer votre machine pendant ce processus d’installation.
Configurer votre nom d’utilisateur et votre mot de passe Linux
Une fois le processus d’installation de votre distribution Linux avec WSL terminé, ouvrez la distribution (Ubuntu par défaut) avec le menu Démarrer. Il vous sera demandé de créer un nom d’utilisateur et un mot de passe pour votre distribution Linux.
Ce nom d’utilisateur et ce mot de passe sont propres à chaque distribution Linux distincte que vous installez et n’ont aucune incidence sur votre nom d’utilisateur Windows.
Notez que rien ne s’affiche à l’écran quand vous entrez le mot de passe. Cela s’appelle la saisie à l’aveugle. Vous ne verrez pas ce que vous tapez, ce qui est tout à fait normal.
Une fois que vous avez créé un nom d’utilisateur et un mot de passe, le compte devient votre utilisateur par défaut pour la distribution et se connecte automatiquement au démarrage.
Ce compte est considéré comme l’administrateur Linux, avec la capacité d’exécuter des commandes d’administration sudo (Super User Do).
Chaque distribution Linux exécutée sur WSL a ses propres comptes d’utilisateur et mots de passe Linux. Vous devez configurer un compte d’utilisateur Linux chaque fois que vous ajoutez, réinstallez ou réinitialisez une distribution.
Pour modifier ou réinitialiser votre mot de passe, ouvrez la distribution Linux et entrez la commande : passwd. Vous êtes invité à entrer votre mot de passe actuel, à entrer votre nouveau mot de passe, puis à confirmer votre nouveau mot de passe.
Si vous avez oublié le mot de passe de votre distribution Linux :
Ouvrez PowerShell et entrez la racine de votre distribution WSL par défaut en utilisant la commande : wsl -u root
Si vous devez mettre à jour le mot de passe oublié sur une distribution qui n’est pas celle par défaut, utilisez la commande : wsl -d Debian -u root en remplaçant Debian par le nom de votre distribution ciblée.
Une fois votre distribution WSL ouverte au niveau de la racine dans PowerShell, vous pouvez utiliser cette commande pour mettre à jour votre mot de passe passwd <username>, où <username> est le nom d’utilisateur du compte de la distribution pour laquelle vous avez oublié le mot de passe.
Vous serez invité à entrer un nouveau mot de passe UNIX, puis à confirmer ce mot de passe. Une fois que vous êtes informé de la bonne mise à jour du mot de passe, fermez WSL dans PowerShell en utilisant la commande exit.
Mettre à jour et mettre à niveau des packages
Nous vous recommandons de mettre régulièrement à jour et à niveau vos packages à l’aide du gestionnaire de package préféré pour la distribution. Pour Ubuntu ou Debian, utilisez la commande :
sudo apt update && sudo apt upgrade
Windows ne met pas automatiquement à jour ou à niveau vos distributions Linux. Il s’agit d’une tâche que la plupart des utilisateurs Linux préfèrent contrôler eux-mêmes.
Windows Terminal peut exécuter n’importe quelle application avec une interface de ligne de commande. Ses principales fonctionnalités comprennent un affichage multi-onglet, des volets, une prise en charge des caractères Unicode et UTF-8, un moteur de rendu de texte accéléré par GPU, ainsi que la possibilité de créer vos propres thèmes et de personnaliser le texte, les couleurs, les arrière-plans et les touches de raccourci.
À chaque fois qu’une nouvelle distribution Linux WSL est installée, une nouvelle instance, qui peut être personnalisée selon vos préférences, est créée à l’intérieur de Terminal Terminal.
Nous vous recommandons d’utiliser WSL avec Windows Terminal, surtout si vous envisagez d’utiliser plusieurs lignes de commande. Consultez la documentation Windows Terminal pour obtenir de l’aide sur la configuration et la personnalisation de vos préférences, notamment :
Savoir comment utiliser des arguments de ligne de commande comme l’ouverture d’un terminal avec plusieurs lignes de commande divisées en volets ou onglets de fenêtre
Pour ouvrir votre projet WSL dans l’Explorateur de fichiers Windows, entrez : explorer.exe . Veillez à ajouter le point à la fin de la commande pour ouvrir le répertoire actuel.
Stockez vos fichiers de projet sur le même système d’exploitation que les outils que vous envisagez d’utiliser. Pour des performances de vitesse optimales, stockez vos fichiers dans le système de fichiers WSL si vous travaillez dessus avec des outils Linux dans une ligne de commande Linux (Ubuntu, OpenSUSE, etc.). Si vous utilisez une ligne de commande Windows (PowerShell, invite de commandes) avec des outils Windows, stockez vos fichiers dans le système de fichiers Windows. Les fichiers sont accessibles à travers tous les systèmes d’exploitation, mais cela peut ralentir considérablement les performances.
Par exemple, lors du stockage de vos fichiers de projet WSL :
Utilisez le répertoire racine du système de fichiers Linux : \\wsl$\<DistroName>\home\<UserName>\Project
Et non le répertoire racine du système de fichiers Windows : C:\Users\<UserName>\Project ou /mnt/c/Users/<UserName>/Project$
Configurer votre éditeur de code préféré
Nous vous recommandons d’utiliser Visual Studio Code ou Visual Studio, car ils prennent directement en charge le développement et le débogage à distance avec WSL. Visual Studio Code vous permet d’utiliser WSL en tant qu’environnement de développement complet. Visual Studio offre une prise en charge native de WSL pour le développement multiplateforme C++.
Utiliser Visual Studio Code
Suivez ce guide pas à pas pour bien démarrer avec Visual Studio Code dans WSL, y compris l’installation du pack d’extension de développement à distance. Cette extension vous permet d’exécuter WSL, SSH ou un conteneur de développement pour la modification et le débogage avec l’ensemble complet des fonctionnalités de Visual Studio Code. Échangez rapidement entre différents environnements de développement distincts et effectuez des mises à jour sans vous soucier de l’impact sur votre ordinateur local.
Une fois VS Code installé et configuré, vous pouvez ouvrir votre projet WSL avec un serveur distant VS Code en entrant : code .
Veillez à ajouter le point à la fin de la commande pour ouvrir le répertoire actuel.
Suivez ce guide pas à pas pour bien démarrer avec Git sur WSL et connecter votre projet au système de gestion de versions Git. Il vous permet également d’utiliser le gestionnaire d’informations d’identification pour l’authentification, d’utiliser des fichiers Git Ignore, de comprendre les fins de ligne Git et d’utiliser les commandes Git intégrées à VS Code.
Configuration de conteneurs de développement distants avec Docker
Suivez ce guide pas à pas pour Bien démarrer avec les bases de données sur WSL et connecter votre projet à une base de données dans l’environnement WSL. Démarrez avec MySQL, PostgreSQL, MongoDB, Redis, Microsoft SQL Server ou SQLite.
Configurer l’accélération par GPU pour des performances plus rapides
Suivez ce guide pas à pas pour configurer la formation Machine Learning accélérée par GPU dans WSL et tirer parti du GPU (processeur graphique) de votre ordinateur pour accélérer les charges de travail lourdes en performances.
Commandes WSL basiques
Les distributions Linux que vous installez via WSL sont mieux gérées à l’aide de PowerShell ou de l’invite de commandes Windows (CMD). Consultez le guide de référence des commandes WSL pour obtenir la liste des commandes de base à connaître pour utiliser WSL.
En outre, de nombreuses commandes peuvent être utilisées à la fois sur Windows et sur Linux. Voici quelques exemples :
Mélanger des commandes Linux et Windows : dans cet exemple, la commande Linux ls -la est utilisée pour afficher les fichiers dans le répertoire, puis la commande PowerShell findstr est utilisée pour filtrer les résultats sur les mots contenant « git » : wsl ls -la | findstr "git". Cela peut également être effectué en mélangeant la commande Windows dir avec la commande Linux grep : dir | wsl grep git.
Exécuter l’outil Windows ipconfig.exe avec l’outil Linux Grep : à partir de Bash, entrez la commande ipconfig.exe | grep IPv4 | cut -d: -f2 ou plutôt ipconfig.exe | wsl grep IPv4 | wsl cut -d: -f2 à partir de PowerShell. Cet exemple illustre l’outil ipconfig sur le système de fichiers Windows utilisé pour afficher les valeurs de configuration réseau TCP/IP actuelles, puis filtré uniquement sur le résultat IPv4 avec grep, un outil Linux.
Résolution des problèmes : découvrez les problèmes courants, où signaler les bogues, où demander de nouvelles fonctionnalités et comment contribuer aux documents.
FAQ : trouvez une liste de questions fréquemment posées.
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.
Commentaires sur Windows Subsystem for Linux
Windows Subsystem for Linux est un projet open source. Sélectionnez un lien pour fournir des commentaires :
Dans ce module, vous apprenez à utiliser le Sous-système Windows pour Linux (WSL) avec Visual Studio Code (VS Code). Nous expliquons le processus d’installation et les principes de base de l’utilisation de WSL. De plus, nous installons et utilisons l’extension Visual Studio Code WSL. Enfin, nous montrons comment déboguer et exécuter du code Python dans VS Code au sein de notre environnement WSL.