Analise as funcionalidades de completação de código da GitHub Copilot
GitHub Copilot fornece sugestões no estilo de auto-compleção à medida que introduz o código. Para além das sugestões padrão de autocompletamento, GitHub Copilot também fornece sugestões de próxima edição (NES), que preveem a localização da próxima edição que provavelmente vais fazer e sugerem uma conclusão para ela.
Você recebe sugestões de estilo de preenchimento automático quando executa as seguintes ações:
- Insira uma linha de código parcial ou completa no editor.
- Insira um comentário de código parcial ou completo no editor.
- Insira uma linha de código em branco no editor.
A seguir, as sugestões de edição aparecem automaticamente à medida que editas o código. Eles prevêem qual alteração você provavelmente fará a seguir, com base nas suas edições recentes, e são exibidos com um indicador especial que indica a localização sugerida para a edição.
Gerar uma sugestão de preenchimento automático
GitHub Copilot acelera o desenvolvimento de aplicações ao sugerir completações de código com base no código que estás a escrever.
Por exemplo, suponha que queres criar um método C# chamado addInt que devolve a soma de dois inteiros. Se começares a escrever a assinatura do método, GitHub Copilot sugere o código que acredita que queres criar.
O preenchimento automático sugerido é exibido sem realce de sintaxe colorido. Isso ajuda a diferenciar o preenchimento automático do código existente. Você pode aceitar o código sugerido pressionando a tecla Tab.
Você pode pressionar a tecla Esc para rejeitar uma sugestão.
O exemplo addInt é um pouco simplista, por isso talvez estejas a perguntar-te como GitHub Copilot se comporta com algo mais complexo.
Suponha que você queira criar um método que aceite uma lista de números e retorne a soma dos números primos contidos na lista. Podes nomear o método addPrimeNumbersInNumericList. Quando começas a escrever a assinatura do método, GitHub Copilot gera uma sugestão para ti. Por exemplo:
É importante analisar as sugestões antes de aceitá-las. Esse preenchimento automático parece bom, então você pode aceitar a sugestão pressionando a tecla Tab.
Vamos continuar o cenário um pouco mais.
Depois de a sugestão ser integrada no seu código, nota que o isPrime método está sublinhado a vermelho. Isto porque o isPrime método ainda não existe no código.
GitHub Copilot é treinado para seguir as melhores práticas, que incluem dividir problemas complexos em partes menores e mais geríveis. Neste caso, GitHub Copilot sugere que cries um método isPrime separado para verificar se um número é primo.
GitHub Copilot está pronto para sugerir um excerto de código para o método isPrime. Quando inserires uma linha em branco abaixo do método addPrimeNumbersInNumericList, GitHub Copilot sugere um método isPrime que podes usar.
As sugestões de preenchimento automático aceleram o processo de desenvolvimento fornecendo trechos de código. Mas e se as sugestões não forem exatamente o que você precisa? GitHub Copilot fornece uma interface para gerir sugestões de autocompletamento.
Gerenciar sugestões de preenchimento automático
Quando GitHub Copilot sugere um autocompletamento, também fornece uma interface para gerir as sugestões. Pode aceitar uma sugestão, rever outras sugestões ou rejeitar as sugestões.
Ao passar o ponteiro do mouse sobre uma sugestão de preenchimento automático, são apresentadas várias opções para gerenciar as sugestões.
A interface padrão para gerenciar sugestões inclui as seguintes opções:
- Aceite a sugestão (na íntegra) selecionando Aceitar. Você também pode aceitar a sugestão pressionando a tecla Tab.
- Aceite parcialmente a sugestão selecionando Aceitar Word. Também pode aceitar parcialmente uma sugestão pressionando as
Ctrl+→teclas (seta da direita). - Veja sugestões alternativas selecionando
>ou<. Também pode consultar as sugestões alternativas pressionando asAlt+]teclas ou.Alt+[
Selecionar a opção Aceitar Palavra aceita a próxima palavra numa sugestão. Isso é útil quando você deseja aceitar parte da sugestão e, em seguida, continuar digitando seu próprio código. Por exemplo, pode aceitar a primeira palavra da sugestão de método isPrime.
Continue a selecionar Aceitar Word até aceitar tanto da sugestão quanto quiser.
Selecionar o ícone de reticências (...) à direita do botão Aceitar Word oferece opções adicionais, como Sempre Mostrar a Barra de Ferramentas e Abrir Painel de Conclusãos.
Selecionar a opção Sempre Mostrar a Barra de Ferramentas garante que a barra de ferramentas permanece visível ao usar atalhos de teclado para gerir sugestões de autocompletamento. Selecionar a opção Abrir Painel de Conclusões abre o Painel de Conclusões do GitHub Copilot. A visualização de múltiplas sugestões usando o Painel de Completações do GitHub Copilot é abordada no final desta unidade.
Observação
Para aceitar uma linha inteira de uma sugestão, precisa de configurar um atalho de teclado personalizado para o editor.action.inlineSuggest.acceptNextLine comando. Esta opção não está disponível por defeito na barra de ferramentas.
Gerar sugestões de código a partir de comentários
Além de sugerir um autocompletamento baseado no código, GitHub Copilot pode usar comentários de código para sugerir excertos de código. Use frases em linguagem natural para descrever o código que você deseja criar. Isto permite que o GitHub Copilot proponha sugestões de auto-preenchimento que satisfaçam requisitos específicos. Por exemplo, você pode especificar o tipo de algoritmo que deseja usar em um cálculo ou quais métodos e propriedades deseja adicionar a uma classe.
Voltemos ao exemplo do número primo. Neste ponto, você tem o seguinte código:
Os métodos addPrimeNumbersInNumericList e isPrime parecem estar completos. No entanto, ainda precisa de uma lista de números que possa ser usada como argumento quando chamar o addPrimeNumbersInNumericList método. Você pode escrever um comentário que descreva a lista de números desejada. Por exemplo, uma lista de 100 números aleatórios que variam de 1 e 1000.
Quando começas a introduzir o comentário, GitHub Copilot sugere uma autocompletação que completa o comentário por ti. GitHub Copilot usa o código à sua volta para melhorar as suas sugestões. Por exemplo, se começares a introduzir o comentário // create, GitHub Copilot usa o código à volta para prever o que queres criar. Neste caso, GitHub Copilot usa o método addPrimeNumbersInNumericList para prever que se quer criar a list of numbers.
À medida que continuas a escrever o teu comentário, GitHub Copilot atualiza a sugestão de autocompletamento. Quando estiver pronto para aceitar a sugestão, selecione Aceitar ou pressione a tecla Tab.
Quando crias uma nova linha de código após o comentário, GitHub Copilot começa a gerar um excerto de código com base no comentário e no teu código existente.
Aceite cada uma das sugestões tal como aparecem.
Se o GitHub Copilot não estiver concluído, gera outra sugestão para aceitar.
Se introduzires uma nova linha de código depois de o excerto de código estar concluído, GitHub Copilot gera outra sugestão de autopreenchimento com base nos requisitos do teu projeto de código. Neste caso, GitHub Copilot sugere uma linha de código que chama o método addPrimeNumbersInNumericList, passando a lista chamada numbers.
Veja múltiplas sugestões usando o Painel de Completação GitHub Copilot
Se não estiver satisfeito com as sugestões iniciais de autocompletamento, GitHub Copilot pode abrir um novo separador no editor com mais opções. Pode rever a lista maior de sugestões para encontrar uma melhor correspondência e, em seguida, selecioná-la.
Para demonstrar esse recurso, vamos voltar a um estágio anterior no exemplo de números primos.
Suponha que ainda precisas de criar o isPrime método. Quando insere uma linha em branco abaixo do método addPrimeNumbersInNumericList, GitHub Copilot sugere um método isPrime para si. Este é o mesmo processo que você usou anteriormente. No entanto, suponha que não está satisfeito com as sugestões que GitHub Copilot oferece e gostaria de ver mais opções.
Para abrir o Painel de Completação GitHub Copilot e ver outras sugestões, pressione as teclas Ctrl + Enter. Também pode abrir o menu Mais Ações e selecionar Abrir Painel de Conclusãos.
O Painel de Conclusão GitHub Copilot apresenta até 10 outras sugestões. Reveja as sugestões para encontrar a que melhor se adapta às suas necessidades.
Para aceitar uma sugestão, selecione a etiqueta Aceitar NÚMERO da sugestão abaixo da sugestão. Por exemplo, selecione a etiqueta Aceitar sugestão 1 abaixo da primeira sugestão.
Para rejeitar todas as sugestões, feche o separador.
Resumo
Sugestões de autocompletamento e próximas sugestões de edição ajudam-no a escrever código de forma mais eficiente e precisa. GitHub Copilot fornece sugestões de autocompletamento à medida que introduz o código, e sugestões de edição próximas que preveem a sua próxima edição provável. Você pode gerar uma sugestão de preenchimento automático inserindo uma linha de código parcial ou completa, um comentário de código parcial ou completo ou uma linha de código em branco. Você pode aceitar uma sugestão pressionando a tecla Tab ou descartar as sugestões pressionando a tecla Esc. Você pode gerenciar sugestões usando a barra de ferramentas que aparece quando você passa o mouse sobre uma sugestão. A barra de ferramentas permite-lhe rever sugestões alternativas, aceitar uma sugestão, aceitar uma palavra de uma sugestão ou abrir o Painel de Conclusões do GitHub Copilot para ver mais sugestões.