Introdução ao GitHub Copilot no Visual Studio Code

Experimente o GitHub Copilot

Sobre o GitHub Copilot e o Visual Studio Code

O GitHub Copilot oferece sugestões de preenchimento automático de um programador de par de IA à medida que você cria o código. Para ver mais informações, confira "Sobre o GitHub Copilot".

Usando o Visual Studio Code, você pode ver e incorporar sugestões do GitHub Copilot diretamente no editor. Este guia demonstra como usar o GitHub Copilot dentro do Visual Studio Code para macOS, Windows ou Linux.

Pré-requisitos

• Para usar o GitHub Copilot, é preciso ter uma assinatura ativa do GitHub Copilot. Para ver mais informações, confira "Sobre a cobrança do GitHub Copilot".

• Para usar o GitHub Copilot no Visual Studio Code, o Visual Studio Code precisa estar instalado. Para obter mais informações, confira a página de download do Visual Studio Code.

Como instalar a extensão Visual Studio Code

Para usar o GitHub Copilot, primeiro você precisa instalar a extensão Visual Studio Code.

1. No Visual Studio Code Marketplace, acesse a página da extensão GitHub Copilot e clique em Instalar.
2. Um pop-up será exibido, solicitando que você abra o Visual Studio Code. Clique em Abrir o Visual Studio Code .
3. Na guia "Extensão: GitHub Copilot" no Visual Studio Code, clique em Instalar.
4. Se você ainda não tiver autorizado o Visual Studio Code na conta do GitHub, será solicitado que você entre no GitHub no Visual Studio Code.
   • Se você já tiver autorizado o Visual Studio Code para sua conta no GitHub, o GitHub Copilot será autorizado automaticamente.
5. No navegador, o GitHub solicitará as permissões necessárias para o GitHub Copilot. Para aprovar essas permissões, clique em Autorizar o Visual Studio Code .
6. No Visual Studio Code, na caixa de diálogo "Visual Studio Code", para confirmar a autenticação, clique em Abrir.

Como ver a primeira sugestão

O GitHub Copilot oferece sugestões para várias linguagens e uma ampla variedade de estruturas, mas funciona melhor para Python, JavaScript, TypeScript, Ruby, Go, C# e C++. Os exemplos a seguir estão em JavaScript, mas as outras linguagens funcionarão da mesma forma.

1. No Visual Studio Code, crie um novo arquivo JavaScript ( *.js).
2. No arquivo JavaScript, digite o cabeçalho da função a seguir. O GitHub Copilot vai sugerir automaticamente um corpo inteiro da função em texto esmaecido, como é mostrado abaixo. A sugestão exata pode variar.
   JavaScript

   function calculateDaysBetweenDates(begin, end) {

   1. Para aceitar a sugestão, pressione Tab.

Como ver sugestões alternativas

Para qualquer entrada fornecida, GitHub Copilot podem oferecer várias sugestões. Você pode selecionar qual sugestão usar ou rejeitar todas as sugestões.

1. No Visual Studio Code, crie um novo arquivo JavaScript ( *.js).

2. No arquivo JavaScript, digite o cabeçalho da função a seguir. GitHub Copilot mostrará uma sugestão.

   JavaScript

   function calculateDaysBetweenDates(begin, end) {

3. Opcionalmente, você pode ver sugestões alternativas, quando há alguma disponível.

   Sistema operacional	Ver a próxima sugestão	Ver a sugestão anterior
   macOS	Opção (⌥) ou Alt+]	Opção (⌥) ou Alt+[
   Windows	Alt+]	Alt+[
   Linux	Alt+]	Alt+[

4. Como alternativa, você pode focalizar a sugestão para ver a paleta de comandos do GitHub Copilot e escolher sugestões.

5. Para aceitar uma sugestão, pressione Tab. Para rejeitar todas as sugestões, pressione Esc.

Como ver várias sugestões em uma nova guia

Você pode não querer nenhuma das sugestões iniciais que o GitHub Copilot oferece. Você pode usar um atalho de teclado para solicitar que GitHub Copilot mostre várias sugestões em uma nova guia.

1. No Visual Studio Code, crie um novo arquivo JavaScript ( *.js).
2. No arquivo JavaScript, digite o cabeçalho da função a seguir. GitHub Copilot mostrará uma sugestão.
   JavaScript

   function calculateDaysBetweenDates(begin, end) {

3. Para abrir uma nova guia com várias opções adicionais, pressione Ctrl+Enter.
4. Para aceitar uma sugestão, acima da sugestão, clique em Aceitar Solução. Para rejeitar todas as sugestões, feche a guia.

Como gerar sugestões de código por meio de comentários

Você pode descrever algo que deseja fazer usando linguagem natural em um comentário e o GitHub Copilot sugerirá o código para atingir sua meta.

1. No Visual Studio Code, crie um novo arquivo JavaScript ( *.js).
2. No arquivo JavaScript, digite o comentário a seguir. O GitHub Copilot vai sugerir uma implementação da função.
   JavaScript

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

Como usar uma estrutura

Você também pode usar o GitHub Copilot para gerar sugestões de APIs e estruturas. O exemplo a seguir usa o GitHub Copilot para criar um servidor Express simples que retorna a hora atual.

1. No Visual Studio Code, crie um novo arquivo JavaScript ( *.js).
2. No arquivo JavaScript, digite o comentário a seguir e pressione Enter. O GitHub Copilot vai sugerir uma implementação do aplicativo Express.
   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. Para aceitar cada linha, pressione Tab.

Como habilitar ou desabilitar o GitHub Copilot

Você pode habilitar ou desabilitar o GitHub Copilot de dentro do Visual Studio Code. O ícone de status do GitHub Copilot no painel inferior da janela do Visual Studio Code indica se o GitHub Copilot está habilitado ou desabilitado. Quando ele estiver habilitado, a cor da tela de fundo do ícone corresponderá à cor da barra de status. Quando ele estiver desabilitado, a cor da tela de fundo do ícone se contrastará com a cor da barra de status.

1. Para habilitar ou desabilitar o GitHub Copilot, clique no ícone de status no painel inferior da janela do Visual Studio Code.

2. Quando você estiver desabilitando o GitHub Copilot, será perguntado se deseja desabilitar as sugestões globalmente ou para a linguagem do arquivo em edição no momento.

   • Para desabilitar as sugestões do GitHub Copilot globalmente, clique em Desabilitar Globalmente.
   • Para desabilitar as sugestões do GitHub Copilot para a linguagem especificada, clique em Desabilitar para LINGUAGEM.

Leitura adicional

• GitHub Copilot