Obtendo sugestões de código em seu IDE com GitHub Copilot

Introdução

Este guia demonstra como obter sugestões de código do GitHub Copilot no Visual Studio para Windows. Para ver instruções para outros ambientes de codificação populares, use o alternador de ferramentas na parte superior da página.

Os exemplos neste guia usam C#. No entanto, outras linguagens funcionarão de forma semelhante.

Para saber mais, confira Sugestões de código do GitHub Copilot na sua IDE.

Pré-requisitos

• Acesso a Copilot. Para usar GitHub Copilot em GitHub Copilot no Visual Studio, você precisa de acesso limitado por meio de Copilot Gratuito ou um plano Copilot pago para acesso completo. Confira O que é GitHub Copilot?.

• Versão compatível do Visual Studio. Para usar o GitHub Copilot no Visual Studio, você precisa ter a versão 2022 17.8 ou posterior do Visual Studio para Windows instalada. Para saber mais, confira Instalar o Visual Studio na documentação da Microsoft.

• Extensão do GitHub Copilot para Visual Studio. Para obter instruções sobre como instalar a extensão Copilot, confira Instalar o GitHub Copilot no Visual Studio na documentação da Microsoft.

• Adicione sua conta do GitHub ao Visual Studio. Consulte Adicionar contas do GitHub ao keychain do Visual Studio na documentação da Microsoft.

Obter sugestões de código

O GitHub Copilot oferece sugestões de codificação à medida que você digita. Por exemplo, digite esta assinatura de função em um arquivo C#:

int CalculateDaysBetweenDates(

int CalculateDaysBetweenDates(

O GitHub Copilot sugerirá automaticamente um corpo inteiro de função em texto acinzentado. Para aceitar a sugestão, pressione Tab.

Você também pode descrever algo que deseja fazer usando linguagem natural em um comentário, e Copilot sugerirá o código para alcançar seu objetivo. Por exemplo, digite este comentário no arquivo C#:

using System.Xml.Linq;

var doc = XDocument.Load("index.xhml");

// find all images

using System.Xml.Linq;

var doc = XDocument.Load("index.xhml");

// find all images

O GitHub Copilot sugerirá uma implementação da função. Para aceitar a sugestão, pressione Tab.

Exibir sugestões alternativas

Por exemplo, digite esta assinatura de função em um arquivo C#:

int CalculateDaysBetweenDates(

int CalculateDaysBetweenDates(

GitHub Copilot vai mostrar uma sugestão.

Agora, passe o mouse sobre a sugestão para exibir o controle do GitHub Copilot e escolher sugestões. Para exibir sugestões seguintes ou anteriores, clique no botão de seta para frente ou para trás no controle.

Como alternativa, você pode mostrar sugestões alternativas pressionando Alt+. (ou Alt+,) no teclado.

{Aceitar ou rejeitar sugestão do copilot}

Obter sugestões de comentários

O GitHub Copilot pode sugerir comentários para seu código analisando o código que você escreve e gerando comentários que descrevem o que o código faz. Para os usuários do Copilot Gratuito, as sugestões de comentários contam para o uso mensal do Bate-papo do Copilot, e não para o uso de sugestões de código.

As sugestões de comentário estão disponíveis nas seguintes linguagens:

• C#
• C++

Habilitar sugestões de comentários

Para habilitar sugestões de comentários, você precisa configurar o estilo de comentário no Visual Studio.

Para C++

1. No Visual Studio, no menu Ferramentas, clique em Opções.
2. No painel à esquerda, clique em Editor de Texto.
3. Clique em C++ e, em seguida, estilo de código.
4. No título Estilo de Código , clique em Geral.
5. Em "Comments", selecione Xml Doc Comments na lista suspensa.
6. Selecione Inserir estilo de comentário existente no início de novas linhas ao escrever comentários e Continuar comentários de linha única. Em seguida, clique em OK.
7. Na guia Options, no painel esquerdo, clique em GitHub.
8. Clique em Copilot e, em seguida, editor.
9. Selecione Habilitar descrições geradas por IA para comentários de documentação inseridas automaticamente em idiomas com suporte.

Para o C#

1. No Visual Studio, no menu Ferramentas, clique em Opções.
2. No painel esquerdo, clique em Idiomas.
3. Clique em C#, em seguida, Mais Configurações e Avançado.
4. Em "Comentários", selecione Gerar comentários de documentação XML para ///, Inserir // no início de novas linhas ao escrever comentários // e Inserir * no início de novas linhas ao escrever comentários /**/. Em seguida, clique em OK.
5. Na guia Options, no painel esquerdo, clique em GitHub.
6. Clique em Copilot e, em seguida, editor.
7. Selecione Habilitar descrições geradas por IA para comentários de documentação inseridas automaticamente em idiomas com suporte.

Usar sugestões de comentários

Para iniciar sugestões de comentário, digite o iniciador de comentários padrão para a linguagem na qual você está escrevendo (por exemplo, ///) antes do código que você deseja comentar e aguarde a sugestão aparecer.

Para aceitar a sugestão, pressione Tab. Para modificar a sugestão, pressione Alt+/. Para rejeitar a sugestão, pressione Esc.

Como navegar e aceitar próximas sugestões de edição

Com base nas edições que você fizer, o Copilot vai prever o local da próxima edição que você provavelmente fará e sugerir um preenchimento para ela.

Você pode navegar pelas alterações de código sugeridas usando Tab, facilitando a localização da próxima edição relevante sem pesquisar manualmente por arquivos ou referências. Pressione Tab para aceitar uma sugestão.

Uma seta na medianiz indica uma sugestão de edição disponível. Clique na seta para acessar o menu de sugestões de edição, que oferece atalhos de teclado. Se uma sugestão de edição estiver fora do modo de exibição atual do editor, a seta apontará para cima ou para baixo para indicar onde está a próxima sugestão.