1. Installation VS Code#

Dans l'écosystème du développement Python, deux environnements de développement intégrés (IDE) prédominent actuellement (2025) : Visual Studio Code et PyCharm.

Ce guide adopte spécifiquement Visual Studio Code comme plateforme de référence pour l'implémentation et la configuration des outils d'amélioration de la qualité du code Python. Cette standardisation permet une reproduction fidèle des configurations présentées dans les démonstrations et templates fournis.

Installation macOS (ou système d'exploitation Linux)

Si vous utilisez actuellement macOS ou un système d'exploitation Linux comme Ubuntu, l’installation est la suivante:

Téléchargement

Visitez code.visualstudio.com
Cliquez sur le bouton "Télécharger pour Mac"

Installation

Ouvrez le fichier téléchargé (.dmg)
Glissez l'icône VS Code dans le dossier Applications
Éjectez l'image disque

Configuration de la commande `code`

Lancez VS Code
Appuyez sur Cmd + Shift + P (macOS) ou Ctrl + Shift + P (Linux)
Tapez Shell Command et sélectionnez "Install 'code' command in PATH"

Installation Windows & WSL2 (Windows Subsystem for Linux)

L'activation de WSL nécessite une demande via le portail de services de l'entreprise : Service Portal

L'écosystème de développement moderne s'appuie majoritairement sur des environnements Linux, tant pour la création que pour le déploiement des applications. Cette réalité technique crée un déséquilibre pour les développeurs Windows.

Le défi Windows dans l'écosystème Python : Les utilisateurs Windows font face à des limitations significatives : documentation incomplète, outils non compatibles, ou configurations complexes pour de nombreuses bibliothèques Python essentielles.

L'importance du terminal Linux : Le terminal Linux constitue l'interface de référence pour la majorité des outils de développement.

Comme l’objectif de ce guide est de développer du code Python destiné à la mise en production, investir dans l'accès à un terminal Linux – que ce soit via WSL, une machine virtuelle, ou un environnement cloud – représente un investissement stratégique qui facilitera considérablement le développement.

Cette étape initiale peut éviter de nombreuses frustrations techniques et permet de se concentrer sur l'apprentissage des concepts MLOps plutôt que sur la résolution de problèmes de compatibilité.

Installez VS Code sur Windows :

Visitez code.visualstudio.com
Téléchargez et exécutez l'installateur Windows
Suivez les instructions (gardez les options par défaut)

Installez WSL2 (https://learn.microsoft.com/en-us/windows/wsl/install) :

Ouvrez PowerShell en administrateur (très important!)
Exécutez : wsl --install (Par défaut, installation de la distribution Ubuntu).
Redémarrez votre ordinateur
Entrez votre nouveau nom d'utilisateur UNIX et définissez un mot de passe (sans espace ni caractères spéciaux) – cette étape est importante pour l'exécution des commandes administrateur avec "sudo"

Vous pouvez trouver le sous-système Windows pour Linux (terminal) en retournant dans la barre de recherche et en cherchant “Ubuntu”.

Pourquoi utiliser WSL2 ?

Le sous-système Windows pour Linux2 (WSL2) fonctionne comme un environnement Linux virtualisé intégré à Windows. En pratique, il permet d'exécuter simultanément deux systèmes d'exploitation – Windows et Linux – qui partagent un même système de fichiers. Concrètement, lorsque vous travaillez dans l'environnement Linux, vous pouvez créer et modifier des fichiers texte, des images et d'autres documents qui sont physiquement stockés sur votre disque dur. Ces mêmes fichiers vont également être accessibles depuis Windows. C'est comme avoir deux interfaces différentes pour interagir avec le même espace de stockage – vous disposez essentiellement de deux systèmes d'exploitation sur une seule machine qui partagent un espace de travail commun.

Cette configuration offre l'avantage de pouvoir accéder et modifier des fichiers résidant sur un disque Windows directement depuis l'environnement Linux, créant ainsi une expérience de développement simplifiée avec les outils Linux tout en conservant l'interface Windows. Cette approche offre un environnement Linux et une intégration native avec VS Code via l’extension Remote-WSL.

Il existe d’autres alternatives à Windows Subsystem for Linux : Machines Virtuelles (VirtualBox, VMware), Git Bash, Docker Desktop et Dual Boot Windows/Linux, entre autres. Cependant, WSL2 représente le meilleur compromis pour la plupart des développeurs sur Windows. Les alternatives ont chacune leurs cas d'usage spécifiques, mais très peu offrent l'équilibre de WSL2 pour le développement avec VS Code.

Installez l'extension WSL de VS Code :

Bien que VS Code intègre un terminal PowerShell, notre objectif est d'utiliser un terminal Linux directement depuis l'éditeur. Pour créer cette passerelle entre l'environnement Windows et le sous-système Linux (WSL2), une extension spécialisée est nécessaire.

Lancez Visual Studio Code
Allez dans l'onglet Extensions (Ctrl+Shift+X)
Recherchez "WSL" et installez l'extension "WSL" développée par Microsoft

Connexion à WSL2 :

Cliquez sur l'icône verte en bas à gauche de VS Code
Sélectionnez "Connect to WSL" dans le menu

Cette connexion établit un pont entre deux environnements : votre interface VS Code (qui s'affiche sur Windows) communique désormais avec un serveur VS Code qui s'exécute à l'intérieur de votre environnement Linux WSL2. En pratique, cela signifie que vous gardez l'interface familière de VS Code sur Windows, mais tous vos outils de développement, votre terminal et vos fichiers de projet fonctionnent dans l'environnement Linux. Cette configuration "client-serveur" vous offre le meilleur des deux mondes : la convivialité de l'interface Windows et la puissance de l'écosystème Linux.

Installation de la commande `code` dans WSL2 :

Depuis le terminal WSL2 (Ubuntu), la commande sera automatiquement disponible.

Testez avec code . pour ouvrir un dossier

Lancement de VS Code depuis l'environnement WSL2

Pour ouvrir VS Code avec toutes vos configurations WSL2 actives :

Ouvrez Ubuntu depuis le menu Démarrer de Windows (recherchez "Ubuntu")
Naviguez vers votre dossier de projet avec la commande cd
Lancez VS Code avec la commande : code .

Le point . est important : il indique à VS Code d'ouvrir le répertoire courant comme espace de travail. Cette méthode garantit que VS Code démarre avec la bonne configuration WSL2 et que tous vos outils de développement Python fonctionnent dans l'environnement Linux optimal.

Cette simple commande code . va automatiquement :

Ouvrir VS Code sur votre système Windows
Établir la connexion avec l'environnement WSL2
Charger votre projet avec tous les outils Linux disponibles
Activer le terminal Linux intégré

Alternative pratique :

Si vous avez déjà un dossier ouvert dans VS Code sous Windows, vous pouvez facilement basculer vers WSL2 en cliquant sur l'icône verte en bas à gauche et en sélectionnant "Reopen Folder in WSL". Cette option permet de migrer instantanément votre espace de travail actuel vers l'environnement Linux sans avoir à fermer et rouvrir manuellement le projet.

Raccourcis clavier VS Code

Pour gagner en efficacité dans votre travail quotidien, rien ne remplace la maîtrise des raccourcis clavier. Comme toute compétence technique, leur acquisition demande de la pratique et de la régularité, mais l'investissement en vaut largement la peine.

Nous vous encourageons à télécharger et garder à portée de main le guide officiel correspondant à votre système :

Pour débuter efficacement, ces deux raccourcis vous feront économiser de nombreux clics :

Accéder rapidement à toutes les fonctionnalités :
Windows/Linux : Ctrl + Maj + P
MacOS : Cmd + Maj + P
Basculer vers le terminal intégré sans quitter votre éditeur :
Windows/Linux : Ctrl + `
MacOS : Cmd + J