Getting started with GitHub Copilot

About GitHub Copilot and Visual Studio Code

GitHub Copilot proporciona sugerencias de estilo autocompletar de un programador de pares de IA a medida que programa. Para obtener más información, vea «Acerca 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

• Para usar GitHub Copilot debes tener una suscripción de GitHub Copilot. Para obtener más información, vea «Acerca de la facturación 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 proporciona sugerencias para numerosos lenguajes y una amplia variedad de marcos, pero funciona especialmente bien para Python, JavaScript, TypeScript, Ruby, Go, C# y C++. GitHub Copilot también puede ayudar en la generación de consultas para bases de datos. The following samples are in JavaScript, but other languages will work similarly.

1. En Visual Studio Code, crea un archivo de 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. Para aceptar la sugerencia, presiona Tab.

Seeing alternative suggestions

Para cualquier entrada determinada, GitHub Copilot puede ofrecer varias sugerencias. Puedes seleccionar qué sugerencia usar o rechazar todas las sugerencias.

1. En Visual Studio Code, crea un archivo de 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. Opcionalmente, puedes ver sugerencias alternativas, si hay alguna disponible.

   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. Para aceptar una sugerencia, presiona Tab. Para rechazar todas las sugerencias, presiona Esc.

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. En Visual Studio Code, crea un archivo de 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 "Configuración de GitHub Copilot en tu entorno."

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

Es posible que no quieras ninguna de las sugerencias iniciales que GitHub Copilot ofrece. Puedes usar un método abreviado de teclado para solicitarle a GitHub Copilot que te muestre varias sugerencias en una pestaña nueva.

1. En Visual Studio Code, crea un archivo de 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

Puedes describir algo que quieres hacer con el lenguaje natural dentro de un comentario y GitHub Copilot te sugerirá el código que debes usar para lograr tu objetivo.

1. En Visual Studio Code, crea un archivo de 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. En Visual Studio Code, crea un archivo de 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.

Habilitación o deshabilitación de GitHub Copilot

Puedes habilitar o deshabilitar GitHub Copilot desde Visual Studio Code. El icono de estado de GitHub Copilot en el panel inferior de la ventana Visual Studio Code indica si GitHub Copilot está habilitado o deshabilitado. Cuando está habilitado, el color de fondo del icono coincidirá con el color de la barra de estado. Cuando está deshabilitado, el color de fondo del icono contrastará con el color de la barra de estado.

1. Para habilitar o deshabilitar GitHub Copilot, haz clic en el icono de estado en el panel inferior de la ventana Visual Studio Code.

   

2. Si deshabilitas GitHub Copilot, se te preguntará si quieres deshabilitar las sugerencias de forma global o para el idioma del archivo que estás editando actualmente.

   • Para deshabilitar las sugerencias de GitHub Copilot de forma global, haz clic en Deshabilitar globalmente.
   • Para deshabilitar las sugerencias de GitHub Copilot para el idioma especificado, haz clic en Deshabilitar para IDIOMA.