Ajoutez des commentaires utiles à votre code avec GitHub Copilot – guide pour débutants

Téléchargez et installez Visual Studio Code

Rendez-vous sur code.visualstudio.com dans n'importe quel navigateur ; vous verrez un gros bouton qui indique généralement « Download for Windows », « Download for macOS » ou « Download for Linux ». Cliquez sur ce bouton, puis ouvrez le programme d'installation qui arrive dans votre dossier Téléchargements (il se termine par .exe, .dmg, .deb ou .rpm). L'assistant vous guide à travers quelques écrans – cliquez simplement sur « Next », acceptez la licence, puis appuyez sur « Install ». Une fois l'installation terminée, VS Code se lance et affiche une fenêtre avec une fine barre latérale à gauche et un éditeur central vide. Si le bouton ne correspond pas exactement, cherchez un lien qui dit « Other platforms » ou « Get VS Code for … ». Vous saurez que cela a fonctionné lorsque l'icône VS Code apparaît sur votre bureau ou dans votre dossier d'applications et que le programme s'ouvre sur un éditeur vide.

Connectez-vous à GitHub depuis VS Code

Avec VS Code ouvert, jetez un œil au coin inférieur gauche ; vous devriez voir une petite icône en silhouette – c'est le bouton Accounts (imaginez-le comme la porte qui permet à VS Code de rencontrer votre identité en ligne). Cliquez dessus ; un petit panneau glisse vers le haut en proposant « Sign in with GitHub ». Choisissez cette option ; votre navigateur par défaut s'ouvre et vous demande de confirmer la connexion. Après votre validation, le panneau disparaît et un petit avatar ou vos initiales remplacent la silhouette. Si vous ne voyez pas la silhouette, ouvrez la barre de menus, sélectionnez View → Command Palette, tapez « Sign in » et choisissez l'option qui mentionne GitHub. Vous saurez que cela a fonctionné lorsque votre nom d'utilisateur ou avatar GitHub apparaît dans le coin inférieur gauche de VS Code.

Installez l'extension GitHub Copilot

Dans la barre latérale gauche, cherchez une icône qui ressemble à quatre carrés disposés en grille – cela ouvre la vue Extensions (imaginez un mini app store intégré à VS Code). Cliquez sur l'icône ; un panneau apparaît avec une barre de recherche en haut. Tapez GitHub Copilot dans cette barre. Le premier résultat est l'extension officielle Copilot avec un bouton Install à côté. Cliquez sur Install ; VS Code télécharge l'extension et l'active automatiquement. Une fois le processus terminé, un nouveau logo Copilot (généralement une bulle de chat stylisée) apparaît dans la barre d'activité – la fine bande verticale à l'extrême gauche. Si vous ne voyez pas l'icône à quatre carrés, vous pouvez aussi ouvrir View → Extensions depuis le menu supérieur. Vous saurez que cela a fonctionné lorsque la liste des extensions affiche GitHub Copilot comme « Enabled » et que l'icône Copilot apparaît dans la barre d'activité.

Ouvrez un fichier de code dans l'éditeur

Cliquez sur la première icône de la barre latérale gauche – elle ressemble à deux pages empilées et représente l'Explorer (imaginez-le comme un explorateur de dossiers). Dans le panneau Explorer, naviguez jusqu'à un dossier qui contient un fichier comme example.js ou notes.txt. Faites un simple clic sur le fichier pour le sélectionner, puis un double-clic pour l'ouvrir ; le contenu du fichier remplit la zone d'édition centrale et une colonne de numéros de ligne apparaît à gauche. (Une function est simplement un ensemble nommé d'instructions, comme une fiche de recette, et un comment est une note pour les lecteurs humains que l'ordinateur ignore silencieusement.) Si l'Explorer n'est pas visible, appuyez sur Ctrl+Shift+E (sur macOS, Cmd+Shift+E). Vous saurez que cela a fonctionné lorsque le texte du fichier apparaît dans l'éditeur avec des numéros de ligne descendant sur le côté gauche.

Demandez à GitHub Copilot de suggérer un commentaire au-dessus d'une ligne de code

Placez le curseur sur une ligne vide directement au-dessus de la ligne que vous voulez expliquer. Tapez // suivi d'une instruction courte comme Explain what this line does. Dans de nombreux cas, GitHub Copilot affichera une suggestion en ghost text (texte fantôme) gris clair juste après que vous ayez fini de taper – c'est le comportement d'auto-complétion inline de Copilot. Si le texte fantôme apparaît, appuyez sur Tab pour le transformer en vrai commentaire ; appuyez sur Échap si vous voulez le rejeter et essayer une autre instruction.

Si aucun texte fantôme n'apparaît, cela peut être parce que l'instruction est trop courte ou que l'extension a besoin d'un instant pour se charger. Dans ce cas, vous pouvez utiliser la commande intégrée comme solution de secours : ouvrez la palette de commandes (Ctrl+Shift+P / Cmd+Shift+P) et exécutez « GitHub Copilot: Explain ». Copilot insérera alors un commentaire basé sur la ligne que vous avez sélectionnée.

Vous saurez que cela a fonctionné lorsqu'un commentaire lisible apparaît au-dessus de la ligne ciblée, résumant son objectif en anglais simple.

Examinez, modifiez et enregistrez la suggestion

Lisez à voix haute le commentaire nouvellement inséré ; s'il décrit fidèlement le code, vous avez terminé. Si la formulation n'est pas correcte, cliquez simplement dans la ligne de commentaire et tapez une correction – Copilot n'apprend pas de ces modifications, donc des ajustements manuels sont normaux. Pour finir, enregistrez le fichier en appuyant sur Ctrl+S (ou Cmd+S sur macOS) ; le point à côté du nom du fichier dans l'onglet disparaît, indiquant que le fichier est enregistré. Si vous remarquez que le commentaire reste peu clair, retournez à l'étape 5 et reformulez votre instruction (par exemple, Summarise the tax‑calculation step in plain English).