prise en main de l’utilisation de Visual Studio Code avec Sous-système Windows pour Linux

Visual Studio Code, avec l’extension WSL distante, vous permet d’utiliser WSL en tant qu’environnement de développement à plein temps directement à partir de VS Code. Vous pouvez :

  • développer dans un environnement Linux
  • utiliser des chaînes et des utilitaires spécifiques à Linux
  • exécutez et déboguez vos applications Linux à partir du confort de Windows tout en conservant l’accès aux outils de productivité comme Outlook et Office
  • utiliser le VS Code terminal intégré pour exécuter votre distribution Linux de votre choix
  • tirez parti des fonctionnalités de VS Code telles que la saisie semi-automatique de code Intellisense, ledécodage, la prise en charge du débogage, les extraits de codeet les tests unitaires
  • gérez facilement votre contrôle de version avec la prise en charge intégrée de Git de VS Code
  • exécuter des commandes et des extensions de VS Code directement dans vos projets WSL
  • modifiez des fichiers dans votre système de fichiers Windows Linux ou monté (par exemple/mnt/c) sans vous soucier des problèmes de chemin d’accès, de compatibilité binaire ou d’autres problèmes liés au système d’exploitation.

installer VS Code et l’extension WSL distante

  • accédez à la page d’installation de VS Code et sélectionnez le programme d’installation 32 ou 64 bits. installez Visual Studio Code sur Windows (pas dans votre système de fichiers WSL).

  • Lorsque vous êtes invité à Sélectionner des tâches supplémentaires lors de l’installation, veillez à cocher l’option Ajouter au chemin d’accès afin de pouvoir ouvrir facilement un dossier dans WSL à l’aide de la commande code.

  • Installez le Pack d’extension de développement distant. Ce pack d’extension comprend l’extension WSL distante, en plus des extensions Remote-SSH et Remote-Containers, ce qui vous permet d’ouvrir n’importe quel dossier dans un conteneur, sur un ordinateur distant ou dans WSL.

Important

Pour installer l’extension WSL à distance, vous avez besoin de la version 1,35 de mai ou d’une version ultérieure de vs code. nous vous déconseillons d’utiliser WSL dans VS Code sans l’extension WSL distante, car vous perdrez la prise en charge de la saisie semi-automatique, du débogage, du découpage, etc. Fait amusant : cette extension WSL est installée dans $HOME/.vscode/extensions (entrez la commande ls $HOME\.vscode\extensions\ dans PowerShell).

Mettre à jour votre distribution Linux

certaines distributions Linux WSL ne disposent pas de bibliothèques requises par le serveur VS Code pour démarrer. Vous pouvez ajouter des bibliothèques supplémentaires à votre distribution Linux à l’aide de son gestionnaire de package.

Par exemple, pour mettre à jour Debian ou Ubuntu, utilisez :

sudo apt-get update

Pour ajouter wget (pour récupérer du contenu à partir de serveurs Web) et des certificats d’autorité de certification (pour permettre aux applications SSL de vérifier l’authenticité des connexions SSL), entrez :

sudo apt-get install wget ca-certificates

Ouvrez un projet WSL dans Visual Studio Code

À partir de la ligne de commande

Pour ouvrir un projet à partir de votre distribution WSL, ouvrez la ligne de commande de la distribution, puis entrez : code .

ouvrir le projet WSL avec VS Code serveur distant

À partir de VS Code

vous pouvez également accéder à d’autres options de VS Code à distance à l’aide du raccourci : CTRL+SHIFT+P dans VS Code pour afficher la palette de commandes. si vous tapez, Remote-WSL vous verrez une liste des options à distance disponibles VS Code, ce qui vous permet de rouvrir le dossier dans une session à distance, de spécifier la distribution que vous souhaitez ouvrir dans, et bien plus encore.

palette de commandes de VS Code

Extensions à l’intérieur de VS Code à distance

l’extension WSL distante fractionne les VS Code dans une architecture « client-serveur », avec le client (l’interface utilisateur) en cours d’exécution sur votre ordinateur Windows et le serveur (votre Code, Git, plug-ins, etc.) exécuté à distance.

lors de l’exécution de VS Code à distance, la sélection de l’onglet « extensions » affiche une liste d’extensions comprise entre votre ordinateur local et votre distribution WSL.

L’installation d’une extension locale, comme un thème, ne doit être installée qu’une seule fois.

Certaines extensions, telles que l' extension Python ou tout élément qui gère des éléments tels que le débogage ou le débogage, doivent être installées séparément sur chaque distribution WSL distante. VS Code affichera une icône d’avertissement ⚠, ainsi qu’un bouton « installer en WSL » vert, si une extension installée localement n’est pas installée sur votre ordinateur distant WSL.

VS Code avec les extensions WSL à distance et les extensions locales

pour plus d’informations, consultez les documents VS Code :

  • lorsque VS Code Remote est démarré dans WSL, aucun script de démarrage de l’interpréteur de commandes n’est exécuté. Pour plus d’informations sur l’exécution de commandes supplémentaires ou la modification de l’environnement, consultez l’article script de configuration de l’environnement avancé .

  • vous rencontrez des problèmes lors du lancement de VS Code à partir de votre ligne de commande WSL ? Ce Guide de dépannage contient des conseils sur la modification des variables de chemin d’accès, la résolution des erreurs d’extension sur les dépendances manquantes, la résolution des problèmes de fin de ligne git, l’installation d’un VSIX local sur un ordinateur distant, le lancement d’une fenêtre de navigateur, le port localhost du bloqueur, les sockets Web qui ne fonctionnent pas, les erreurs de stockage des

Installer Git (facultatif)

Si vous envisagez de collaborer avec d’autres personnes ou d’héberger votre projet sur un site open source (comme GitHub), VS Code prend en charge le contrôle de version avec Git. L’onglet Contrôle de code source de VS Code assure le suivi de toutes vos modifications et contient des commandes Git courantes (ajouter, valider, pousser, extraire) intégrées directement dans l’interface utilisateur.

pour installer git, consultez configurer git pour qu’il fonctionne avec Sous-système Windows pour Linux.

Installer le Terminal Windows (facultatif)

le nouveau Terminal Windows active plusieurs onglets (basculer rapidement entre l’invite de commandes, PowerShell ou plusieurs distributions Linux), les combinaisons de touches personnalisées (créez vos propres touches de raccourci pour ouvrir ou fermer les onglets, copier + coller, etc.), les emoji ☺ et les thèmes personnalisés (jeux de couleurs, styles et tailles de police, image d’arrière-plan pour plus d’informations, consultez les documents Terminal Windows.

  1. Procurez-vous le Terminal Windows dans le Microsoft Store : En installant via le Store, les mises à jour sont gérées automatiquement.

  2. une fois l’installation terminée, ouvrez Terminal Windows et sélectionnez Paramètres pour personnaliser votre Terminal à l’aide du fichier.

Ressources supplémentaires

D’autres extensions sont disponibles :

  • Mappages de touches d'autres éditeurs : ces extensions peuvent être utiles si vous utilisiez auparavant un autre éditeur de texte (comme Atom, Sublime, Vim, eMacs, Notepad++, etc.).
  • Synchronisation des paramètres : vous permet de synchroniser vos paramètres VS Code entre différentes installations à l'aide de GitHub. Si vous travaillez sur plusieurs ordinateurs, cela permet de garantir la cohérence de votre environnement.
  • Débogueur pour Chrome: une fois que vous avez terminé le développement côté serveur avec Linux, vous devez développer et tester le côté client. Cette extension intègre votre éditeur VS Code au service de débogage de votre navigateur Chrome, pour plus d'efficacité.