Instalar, configurar e solucionar problemas do GitHub Copilot

  • 7 minutos

Esta unidade explica como se inscrever no GitHub Copilot, como configurar o GitHub Copilot usando o VS Code e como solucionar problemas do GitHub Copilot usando o VS Code.

Inscrever-se no GitHub Copilot

Antes de começar a usar o GitHub Copilot, você precisará configurar uma avaliação gratuita ou assinatura para sua conta.

Para começar, selecione sua foto de perfil do GitHub e selecione Configurações. O Copilot está no menu à esquerda, em Código, planejamento e automação.

Depois de se inscrever, você precisa instalar uma extensão para seu ambiente preferido. O GitHub Copilot é compatível com GitHub.com (que não exige uma extensão), VS Code, Visual Studio, IDEs JetBrains e Neovim, funcionando como uma extensão discreta.

Para este módulo, você examinará apenas as extensões e configurações do VS Code. O exercício que você concluirá na próxima unidade usa o VS Code.

Se estiver usando um ambiente diferente, você poderá encontrar links específicos para configurar esses ambientes na seção "Referências" no final deste módulo.

Configurar o GitHub Copilot no VS Code

Adicionar a extensão do VS Code para o GitHub Copilot

  1. No Visual Studio Marketplace, acesse a página de extensão do GitHub Copilot e selecione Instalar.
  2. Uma caixa de diálogo pop-up solicita que você abra o VS Code. Selecione Abrir.
  3. No VS Code, na guia Extensão: GitHub Copilot, selecione Instalar.
  4. Se você não autorizou anteriormente o VS Code em sua conta do GitHub, será solicitado que você entre no GitHub no VS Code. Selecione Entrar no GitHub.

O GitHub Copilot pode preencher código automaticamente conforme você digita ao usar o VS Code. Após a instalação, você pode habilitar ou desabilitar o GitHub Copilot e definir configurações avançadas no VS Code.

Habilitar ou desabilitar o GitHub Copilot no VS Code

  1. No painel inferior da janela do VS Code, selecione o ícone de status e selecione Habilitar ou Desabilitar.

    Captura de tela do ícone de status do GitHub Copilot no Visual Studio Code. Quando o GitHub Copilot está habilitado, a cor da tela de fundo corresponde à cor da barra de status.

  2. Quando você está desabilitando o GitHub Copilot, o VS Code pergunta se você deseja desabilitar preenchimentos globalmente ou para a linguagem de programação do arquivo que você está editando no momento.

    • Para desabilitar os preenchimentos do GitHub Copilot globalmente, selecione Desabilitar preenchimentos.
    • Para desabilitar as conclusões do GitHub Copilot para um idioma especificado, selecione Desabilitar conclusões para LANGUAGE.

Ativar ou desativar sugestões em linha no VS Code

  1. No menu Arquivo, selecione Preferências>Configurações.

    Captura de tela do menu Arquivo no Visual Studio Code. O submenu suspenso Preferências está aberto com o comando Configurações selecionado.

  2. No painel esquerdo da guia Configurações, selecione Extensões e selecione GitHub Copilot.

  3. Em Editor: Habilitar preenchimentos automáticos, marque ou desmarque a caixa de seleção para habilitar ou desabilitar sugestões embutidas.

Além disso, você pode optar por habilitar ou desabilitar as sugestões embutidas e especificar para quais linguagens deseja habilitar ou desabilitar o GitHub Copilot.

Solucionar problemas do GitHub Copilot no VS Code

No VS Code, os arquivos de log são úteis para diagnosticar problemas de conexão. A extensão do GitHub Copilot armazena os arquivos de log no local de log padrão para extensões do VS Code. Você pode encontrar os arquivos de log abrindo a paleta de comandos e inserindo uma das seguintes opções: Desenvolvedor: Abrir arquivo de log ou Desenvolvedor: Abrir pasta de logs de extensão.

Em casos raros, os erros podem não ser registrados nos locais regulares. Se você encontrar erros e não houver nada nos logs, você poderá tentar ver os logs do processo que executa o VS Code e a extensão. Esse processo permite exibir os logs do Electron. Você pode encontrar esses logs selecionando Ajuda>Ativar/desativar Ferramentas para Desenvolvedores no VS Code.

Restrições de rede, firewalls ou do seu proxy podem causar problemas ao se conectar ao GitHub Copilot. Se ocorrer um problema, use as seguintes etapas para abrir um novo editor com as informações relevantes que você pode inspecionar ou compartilhar com a equipe de suporte:

  1. Abra a paleta de comandos do VS Code e, em seguida:

    • Para Mac, use Shift+Command+P.
    • Para Windows ou Linux, use Ctrl+Shift+P.

  2. Insira Diagnóstico e selecione GitHub Copilot: Coletar diagnósticos da lista.

Para obter mais informações sobre como solucionar problemas em outros ambientes, confira a seção "Referências" no final deste módulo.