Ao aceitar uma sugestão de código do GitHub Copilot no VS Code, pode ser necessário saber de onde ela veio. O Copilot pode gerar código com base no código público em que foi treinado ou no contexto do seu arquivo atual. Sem essa informação, você corre o risco de usar código que pode ter restrição de licença ou que foi extraído de um projeto semelhante que você não pretendia referenciar. Este artigo explica como ver a fonte de uma sugestão do Copilot, por que a fonte é importante e o que fazer quando a fonte não é exibida corretamente.
Principais Conclusões: Visualizar a Fonte da Sugestão do Copilot no VS Code
- Ícone da barra de status do VS Code > Indicador de fonte da sugestão do Copilot: Mostra se uma sugestão veio de código público, do seu arquivo atual ou de um arquivo local correspondente.
- Ctrl+Shift+I (Windows/Linux) ou Cmd+Shift+I (Mac): Abre a caixa de diálogo de fonte da sugestão do Copilot para a última sugestão aceita.
- Comando Copilot: Mostrar Fonte da Sugestão: Abre a mesma caixa de diálogo pela Paleta de Comandos quando você precisa verificar uma sugestão específica.
Por que a Fonte da Sugestão do Copilot é Importante
O GitHub Copilot usa um modelo de linguagem grande treinado em bilhões de linhas de código público. Quando você aceita uma sugestão, o Copilot pode ter correspondido sua solicitação a um trecho específico de seus dados de treinamento. A fonte pode ser de três tipos:
- Código público: A sugestão corresponde a código de repositórios públicos no GitHub. Esse código pode ter licenças de código aberto.
- Seu arquivo atual: A sugestão é gerada com base em padrões do arquivo que você está editando.
- Arquivo local correspondente: A sugestão corresponde a código de outro arquivo no seu workspace.
Saber a fonte ajuda a decidir se você precisa verificar a licença original, atribuir o código ou substituir a sugestão pela sua própria implementação. Isso é especialmente importante em projetos comerciais onde a conformidade com licenças é exigida.
Como Ver a Fonte da Sugestão no VS Code
Siga estas etapas para ver a fonte de uma sugestão do Copilot após aceitá-la.
- Aceite uma sugestão do Copilot
Digite código em um arquivo e pressione Tab quando o Copilot mostrar uma sugestão de texto fantasma. A sugestão agora está inserida no seu arquivo. - Abra a caixa de diálogo de fonte da sugestão
Pressione Ctrl+Shift+I no Windows ou Linux, ou Cmd+Shift+I no Mac. Uma pequena caixa de diálogo aparece mostrando o tipo de fonte e, se aplicável, a URL do repositório ou o caminho do arquivo. - Revise os detalhes da fonte
Se a fonte estiver marcada como Código público, a caixa de diálogo mostra o nome do repositório, o caminho do arquivo e o tipo de licença. Se a fonte for Seu arquivo atual ou Arquivo local correspondente, a caixa de diálogo mostra o nome do arquivo e o número da linha. - Abra o arquivo de origem (opcional)
Clique no link na caixa de diálogo para abrir o arquivo original em uma nova aba do VS Code. Isso permite inspecionar o código exato que o Copilot correspondeu.
Você também pode usar a Paleta de Comandos para ver a fonte. Pressione Ctrl+Shift+P ou Cmd+Shift+P, digite Copilot: Mostrar Fonte da Sugestão e pressione Enter. Este comando mostra a mesma caixa de diálogo para a última sugestão aceita.
Quando a Fonte da Sugestão Não Está Disponível
Em alguns casos, a caixa de diálogo de fonte da sugestão pode mostrar Nenhuma fonte disponível. Isso acontece quando:
- O Copilot gerou a sugestão a partir de seu modelo sem corresponder a nenhum treino de treinamento específico.
- Você não aceitou uma sugestão na sessão atual.
- A extensão do Copilot não está habilitada para o tipo de arquivo atual.
Para resolver isso, certifique-se de ter aceitado pelo menos uma sugestão no arquivo atual. Se a fonte ainda não aparecer, verifique se a extensão do Copilot está ativa procurando pelo ícone do Copilot na barra de status do VS Code. Se o ícone estiver cinza, a extensão está desabilitada. Abra a visualização de Extensões, encontre GitHub Copilot e clique em Habilitar.
Problemas Comuns ao Visualizar a Fonte da Sugestão
O Copilot Mostra Fonte Incorreta para uma Sugestão
Às vezes, a caixa de diálogo de fonte exibe um repositório público que não corresponde ao código que você esperava. Isso pode acontecer se o Copilot correspondeu a uma parte diferente do código. Para verificar, abra o arquivo de origem pela caixa de diálogo e compare o código. Se a correspondência estiver incorreta, você pode ignorar a fonte ou usar o comando Copilot: Descartar Sugestão para remover o código inserido e gerar uma nova sugestão.
O Copilot Não Mostra a Caixa de Diálogo de Fonte
Se pressionar Ctrl+Shift+I ou Cmd+Shift+I não fizer nada, verifique se o atalho de teclado não foi substituído por outra extensão. Abra o editor de Atalhos de Teclado, procure por Copilot: Mostrar Fonte da Sugestão e veja se a combinação de teclas está definida. Se estiver faltando, adicione manualmente clicando no ícone de mais e pressionando a combinação de teclas.
A Fonte da Sugestão do Copilot Mostra Código Público mas Sem Licença
Alguns repositórios públicos não incluem um arquivo de licença. Nesse caso, a caixa de diálogo mostra Sem licença. Sem uma licença, o código é protegido por direitos autorais por padrão, e você não deve usá-lo sem permissão. Substitua a sugestão pela sua própria implementação ou consulte sua equipe jurídica.
Fonte da Sugestão do Copilot vs Fonte do Copilot Chat: Principais Diferenças
| Item | Fonte da Sugestão do Copilot | Fonte do Copilot Chat |
|---|---|---|
| Gatilho | Após aceitar uma sugestão de texto fantasma | Após receber uma resposta no painel de Chat |
| Atalho de teclado | Ctrl+Shift+I ou Cmd+Shift+I | Nenhum atalho dedicado; use a Paleta de Comandos |
| Informações exibidas | Tipo de fonte, URL do repositório, caminho do arquivo, licença | Apenas o tipo de fonte (código público ou seu código) |
| Caso de uso | Verificar licença e atribuição para código inline | Verificar fonte de trechos de código em respostas do chat |
O Copilot Chat mostra um selo de fonte ao lado dos blocos de código na resposta do chat. Clique no selo para ver a URL do repositório e a licença. Isso é útil quando você pede ao Copilot Chat para gerar código e quer verificar sua origem antes de copiá-lo para o seu projeto.
Conclusão
Agora você pode ver a fonte de qualquer sugestão do Copilot no VS Code usando o atalho Ctrl+Shift+I ou Cmd+Shift+I. Verifique a caixa de diálogo de fonte após cada sugestão aceita para garantir a conformidade com licenças de código aberto. Se a fonte mostrar um repositório público sem licença, substitua o código pela sua própria implementação. Para respostas do Copilot Chat, clique no selo de fonte para ver os detalhes do repositório. Essa prática mantém sua base de código legalmente segura e ajuda a entender de onde o Copilot está extraindo seu conhecimento.