Introdução ao GitHub Copilot

Sobre o GitHub Copilot e IDEs JetBrains

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 obter mais informações, confira "Sobre o GitHub Copilot for Individuals".

Se você usar um IDE JetBrains, poderá exibir e incorporar sugestões do GitHub Copilot diretamente no editor. Este guia demonstra como usar o GitHub Copilot dentro de um IDE JetBrains para macOS, Windows ou Linux.

Pré-requisitos

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

• Para usar o GitHub Copilot no JetBrains, você deverá ter um IDE do JetBrains compatível instalado. O GitHub Copilot é compatível com as seguintes IDEs:

  • IntelliJ IDEA (Ultimate, Community, Educational)
  • Android Studio
  • AppCode
  • CLion
  • Code With Me Guest
  • DataGrip
  • DataSpell
  • GoLand
  • JetBrains Client
  • MPS
  • PhpStorm
  • PyCharm (Professional, Community, Educational)
  • Rider
  • RubyMine
  • WebStorm

  Para obter mais informações, confira o localizador de ferramentas JetBrains IDEs.

Instalar a extensão do GitHub Copilot no seu IDE JetBrains

Para usar o GitHub Copilot em um IDE JetBrains, você deverá instalar a extensão do GitHub Copilot. O procedimento a seguir guiará você pela instalação do plug-in do GitHub Copilot no IntelliJ IDEA. As etapas para instalar o plug-in em outro IDE com suporte podem ser diferentes.

1. No IDE JetBrains, no menu Arquivo do Windows, ou sob o nome do IDE para Mac (por exemplo, PyCharm ou IntelliJ), clique em Configurações para o Windows ou em Preferências para o Mac.

2. No menu esquerdo da caixa de diálogo Configurações/Preferências, clique em Plug-ins.

3. Na parte superior da caixa de diálogo Configurações/Preferências, clique em Marketplace. Na barra de pesquisa, pesquise GitHub Copilot e clique em Instalar.

   

4. Depois que o GitHub Copilot estiver instalado, clique em Reiniciar IDE.

5. Depois que o IDE JetBrains for reiniciado, clique no menu Ferramentas. Clique em GitHub Copilot e clique Logon no GitHub .

   

6. Na caixa de diálogo "Entrar no GitHub", para copiar o código do dispositivo e abrir a janela de ativação do dispositivo, clique em Copiar e Abrir.

   

7. Uma janela de ativação do dispositivo será aberta no navegador. Cole o código do dispositivo e clique em Continuar.

8. O GitHub solicitará as permissões necessárias para o GitHub Copilot. Para aprovar essas permissões, clique em Autorizar o plug-in do GitHub Copilot .

9. Depois que as permissões forem aprovadas, o IDE JetBrains mostrará uma confirmação. Para começar a usar o GitHub Copilot, clique em OK.

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 Java, mas outras linguagens funcionarão da mesma forma.

1. No IDE da JetBrains, crie um arquivo Java ( *.java).
2. No arquivo Java, crie uma classe digitando class Test. GitHub Copilot vai sugerir automaticamente um corpo de classe em texto esmaecido. A sugestão exata pode variar.
3. Para aceitar a sugestão, pressione Tab.
4. Para solicitar que o GitHub Copilot sugira um corpo de função, digite a linha a seguir abaixo do colchete da função main. A sugestão exata pode variar.
   Java

   int calculateDaysBetweenDates(
   ``` 1. Para aceitar a sugestão, pressione <kbd>Tab</kbd>.

O GitHub Copilot tentará fazer a correspondência entre o contexto e o estilo do seu código. Você sempre poderá editar o código sugerido.

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 IDE da JetBrains, crie um arquivo Java ( *.java).

2. Para solicitar que o GitHub Copilot mostre uma sugestão, digite a linha a seguir no arquivo Java.

   Java

   int calculateDaysBetweenDates(
   ``` 1. 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 | <kbd>Opção</kbd>+<kbd>]</kbd> | <kbd>Opção</kbd>+<kbd>[</kbd> |
   | Windows | <kbd>Alt</kbd>+<kbd>]</kbd> | <kbd>Alt</kbd>+<kbd>[</kbd> |
   | Linux | <kbd>Alt</kbd>+<kbd>]</kbd> | <kbd>Alt</kbd>+<kbd>[</kbd> |

3. 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 IDE da JetBrains, crie um arquivo Java ( *.java).

2. Para solicitar que o GitHub Copilot mostre uma sugestão, digite a linha a seguir no arquivo Java.

   Java

   int calculateDaysBetweenDates(

3. Abra uma nova guia com várias sugestões adicionais.

   • No macOS, pressione Command+Shift+A e clique em Abrir o GitHub Copilot ou pressione Command+Shift+\ para abrir a nova guia imediatamente.
   • No Windows ou Linux, pressione Ctrl+Enter e clique em Abrir o GitHub Copilot.

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 IDE da JetBrains, crie um arquivo Java ( *.java).
2. Para solicitar que o GitHub Copilot sugira uma implementação de uma função no arquivo Java, digite as linhas a seguir.
   Java

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

Como habilitar e desabilitar o GitHub Copilot

Você pode habilitar ou desabilitar o GitHub Copilot para todas as linguagens ou para linguagens individuais. O ícone de status do GitHub Copilot no painel inferior da janela do IDE JetBrains indica se o GitHub Copilot está habilitado ou desabilitado. Quando habilitado, o ícone fica realçado. Quando desabilitado, o ícone fica esmaecido.

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

   

2. Se você estiver desabilitando o GitHub Copilot, será perguntado se deseja desabilitá-lo globalmente ou para a linguagem do arquivo que está editando no momento.

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

   

Leitura adicional

• O site do GitHub Copilot
• Sobre o GitHub Copilot for Individuals