Getting started with GitHub Copilot

About GitHub Copilot and Visual Studio Code

GitHub Copilot fournit des suggestions de type autocomplétion de la part d’un programmeur en binôme d’IA pendant que vous codez. Pour plus d’informations, consultez « À propos de GitHub Copilot Individual ».

If you use Visual Studio Code, you can view and incorporate suggestions from GitHub Copilot directly within the editor. This guide demonstrates how to use GitHub Copilot within Visual Studio Code for macOS, Windows, or Linux.

Prerequisites

• Pour utiliser GitHub Copilot, vous devez disposer d’un abonnement GitHub Copilot actif. Pour plus d’informations, consultez « À propos de la facturation de GitHub Copilot ».

• To use GitHub Copilot in Visual Studio Code, you must have Visual Studio Code installed. For more information, see the Visual Studio Code download page.

Installing the GitHub Copilot extension in Visual Studio Code

To use GitHub Copilot, you must first install the GitHub Copilot extension.

1. In the Visual Studio Code Marketplace, go to the GitHub Copilot extension page and click Install.

2. A popup will appear, asking to open Visual Studio Code. Click Open Visual Studio Code.

3. In the "Extension: GitHub Copilot" tab in Visual Studio Code, click Install.

4. If you have not previously authorized Visual Studio Code in your GitHub account, you will be prompted to sign in to GitHub in Visual Studio Code.

   • If you have previously authorized Visual Studio Code for your account on GitHub, GitHub Copilot will be automatically authorized.

   • If you don't get the prompt to authorize, click the bell icon in the bottom panel of the Visual Studio Code window.

     

5. In your browser, GitHub will request the necessary permissions for GitHub Copilot. To approve these permissions, click Authorize Visual Studio Code.

6. To confirm the authentication, in Visual Studio Code, in the "Visual Studio Code" dialog box, click Open.

Seeing your first suggestion

GitHub Copilot fournit des suggestions pour de nombreux langages et un large éventail d’infrastructures, mais fonctionnent particulièrement bien pour Python, JavaScript, TypeScript, Ruby, Go, C# et C++. GitHub Copilot peut également aider à générer des requêtes pour les bases de données. The following samples are in JavaScript, but other languages will work similarly.

1. Dans Visual Studio Code, créez un fichier JavaScript ( *.js).

2. In the JavaScript file, type the following function header. GitHub Copilot will automatically suggest an entire function body in grayed text, as shown below. The exact suggestion may vary.

   JavaScript

   function calculateDaysBetweenDates(begin, end) {
   

3. Pour accepter la suggestion, appuyez sur Tab.

Seeing alternative suggestions

Pour n’importe quelle entrée donnée, GitHub Copilot peut proposer plusieurs suggestions. Vous pouvez sélectionner la suggestion à utiliser ou rejeter toutes les suggestions.

1. Dans Visual Studio Code, créez un fichier JavaScript ( *.js).

2. In the JavaScript file, type the following function header. GitHub Copilot will show you a suggestion.

   JavaScript

   function calculateDaysBetweenDates(begin, end) {
   

3. Vous pouvez éventuellement voir les suggestions alternatives, si elles sont disponibles.

   OS	See next suggestion	See previous suggestion
   macOS	Option (⌥) or Alt+]	Option (⌥) or Alt+[
   Windows	Alt+]	Alt+[
   Linux	Alt+]	Alt+[

4. Alternatively, you can hover over the suggestion to see the GitHub Copilot command palette for choosing suggestions.

5. Pour accepter une suggestion, appuyez sur Tab. Pour rejeter toutes les suggestions, appuyez sur Échap.

Partially accepting suggestions

You may not want to accept an entire suggestion from GitHub Copilot. You can use keyboard shortcuts to accept either the next word of a suggestion, or the next line.

1. Dans Visual Studio Code, créez un fichier JavaScript ( *.js).

2. In the JavaScript file, type the following function header. GitHub Copilot will automatically suggest an entire function body in grayed text, as shown below. The exact suggestion may vary.

   JavaScript

   function calculateDaysBetweenDates(begin, end) {
   

3. If you want to accept only the next word of the suggestion, use one of the following keyboard shortcuts.

   OS	Accept Next Word
   macOS	Command+→
   Windows	Control+→
   Linux	Control+→

4. If you want to accept the next line of the suggestion, you will need to set a custom keyboard shortcut for the command editor.action.inlineSuggest.acceptNextLine. For more information on setting custom keyboard shortcuts, see "Configuration de GitHub Copilot dans votre environnement."

5. Alternatively, you can hover over the suggestion to see the GitHub Copilot command palette for choosing suggestions.

Seeing multiple suggestions in a new tab

Il se peut que vous ne vouliez aucune des suggestions initiales proposées par GitHub Copilot. Vous pouvez utiliser un raccourci clavier pour demander à GitHub Copilot de vous montrer plusieurs suggestions dans un nouvel onglet.

1. Dans Visual Studio Code, créez un fichier JavaScript ( *.js).

2. In the JavaScript file, type the following function header. GitHub Copilot will show you a suggestion.

   JavaScript

   function calculateDaysBetweenDates(begin, end) {
   

3. To open a new tab with multiple additional options, press Ctrl+Enter.

4. To accept a suggestion, above the suggestion, click Accept Solution. To reject all suggestions, close the tab.

Generating code suggestions from comments

Vous pouvez décrire quelque chose que vous voulez faire en utilisant du langage naturel dans un commentaire : GitHub Copilot va alors suggérer le code pour réaliser votre objectif.

1. Dans Visual Studio Code, créez un fichier JavaScript ( *.js).

2. In the JavaScript file, type the following comment. GitHub Copilot will suggest an implementation of the function.

   JavaScript

   // find all images without alternate text
   // and give them a red border
   function process() {
   

Using a framework

You can also use GitHub Copilot to generate suggestions for APIs and frameworks. The following example uses GitHub Copilot to create a simple Express server that returns the current time.

1. Dans Visual Studio Code, créez un fichier JavaScript ( *.js).

2. In the JavaScript file, type the following comment and then press Enter. GitHub Copilot will suggest an implementation of the Express app.

   JavaScript

   // Express server on port 3000
   

3. To accept each line, press Tab, then Enter.

4. Type the following comment and then press Enter. GitHub Copilot will suggest an implementation for the default handler.

   JavaScript

   // Return the current time
   

5. To accept each line, press Tab.

Activation ou désactivation de GitHub Copilot

Vous pouvez activer ou désactiver GitHub Copilot à partir de Visual Studio Code. L’icône d’état de GitHub Copilot dans le panneau inférieur de la fenêtre Visual Studio Code indique si GitHub Copilot est activé ou désactivé. Lorsque cette option est activée, la couleur d’arrière-plan de l’icône correspond à la couleur de la barre d’état. Lorsqu’elle est désactivée, la couleur d’arrière-plan de l’icône contraste avec la couleur de la barre d’état.

1. Pour activer ou désactiver GitHub Copilot, cliquez sur l’icône d’état dans le panneau inférieur de la fenêtre Visual Studio Code.

   

2. Si vous désactivez GitHub Copilot, il vous sera demandé si vous souhaitez désactiver les suggestions de manière globale ou pour le langage du fichier que vous êtes en train de modifier.

   • Pour désactiver les suggestions de GitHub Copilot globalement, cliquez sur Désactiver globalement.
   • Pour désactiver les suggestions de GitHub Copilot pour le langage spécifié, cliquez sur Désactiver pour LANGAGE.