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

Introdução

Este guia demonstra como obter sugestões de codificação para GitHub CopilotVisual Studio 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 , GitHub CopilotVisual Studiovocê precisa de acesso limitado por meio Copilot Gratuito ou de um plano pago Copilot para acesso total. 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

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

int CalculateDaysBetweenDates(

int CalculateDaysBetweenDates(

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

Você também pode descrever algo que deseja fazer usando a linguagem natural em um comentário e Copilot sugerirá o código para atingir sua meta. 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

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

Exibir 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.

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

int CalculateDaysBetweenDates(

int CalculateDaysBetweenDates(

GitHub Copilot mostrará uma sugestão.

Agora passe o mouse sobre a sugestão para mostrar o GitHub Copilot controle para 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.

Para aceitar uma sugestão, clique em "Aceitar" na paleta de comandos do Copilot ou pressione Tab. Para rejeitar todas as sugestões, pressione Esc.

Obter sugestões de comentários

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 Copilot Gratuito os usuários, as sugestões de comentário contam para o uso mensal Bate-papo do Copilot , 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ário, você precisa configurar o estilo de comentário em Visual Studio.

Para C++

1. No Visual Studiomenu 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 Studiomenu 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.

Navegando e aceitando próximas sugestões de edição

Com base nas edições que você está fazendo, Copilot preverá o local da próxima edição que você provavelmente fará e sugerirá uma conclusão 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.