A barra lateral do GitHub Copilot Chat no Visual Studio Code pode exibir erros como “Falha ao carregar” ou “Conexão recusada” ao tentar abri-la. Esses erros geralmente ocorrem devido a um cache de extensão corrompido, uma versão desatualizada do VS Code ou um firewall bloqueando a conexão com os servidores do GitHub. Este artigo explica por que os erros acontecem e fornece correções passo a passo para restaurar a barra lateral do chat.
Principais Pontos: Corrigindo Erros na Barra Lateral do GitHub Copilot Chat
- VS Code > Extensões > Copilot Chat > Desativar e Ativar: Atualiza o estado da extensão e limpa erros transitórios.
- VS Code > Desenvolvedor: Recarregar Janela: Recarrega todas as extensões e a interface do VS Code sem reiniciar o editor.
- VS Code > Configurações > Extensões > Copilot > GitHub Copilot: Habilitar: Garante que a extensão principal do Copilot esteja ativa antes que a extensão Chat possa conectar.
Por que a Barra Lateral do Copilot Chat Falha ao Carregar
A barra lateral do Copilot Chat no VS Code depende da extensão principal do GitHub Copilot e de uma conexão estável com a API do GitHub. Quando a barra lateral exibe um erro, um desses componentes está quebrado. A causa raiz mais comum é um cache de extensão local corrompido após uma atualização ou uma mudança de rede. O VS Code armazena dados de extensão em um cache local que pode se tornar obsoleto ou corromper quando a extensão é atualizada ou quando o sistema alterna entre redes. Se o cache contiver tokens ou arquivos de estado desatualizados, a extensão Chat não consegue autenticar ou carregar a interface. Outra causa frequente é uma versão desatualizada do VS Code que não possui as APIs necessárias para a extensão Chat renderizar corretamente. Por fim, firewalls corporativos ou VPNs podem bloquear a conexão WebSocket que o Copilot Chat usa para comunicação em tempo real.
Correções Passo a Passo para Erros na Barra Lateral do Copilot Chat
Tente estas correções em ordem. Após cada correção, teste a barra lateral do Copilot Chat clicando no ícone do Copilot na barra de atividades ou pressionando Ctrl+Shift+I.
Correção 1: Desativar e Reativar a Extensão Copilot Chat
- Abra a visualização de Extensões
Pressione Ctrl+Shift+X para abrir o painel de Extensões no VS Code. - Localize o GitHub Copilot Chat
Na caixa de pesquisa no topo do painel de Extensões, digite “GitHub Copilot Chat”. A extensão deve aparecer na lista Instaladas. - Desative a extensão
Clique no ícone de engrenagem ao lado do nome da extensão e selecione Desativar. O VS Code solicitará que você recarregue a janela. Clique em Recarregar. - Reative a extensão
Após recarregar a janela, volte ao painel de Extensões, encontre o GitHub Copilot Chat novamente, clique no ícone de engrenagem e selecione Ativar. O VS Code recarregará a janela uma segunda vez. - Teste a barra lateral
Pressione Ctrl+Shift+I para abrir a barra lateral do Copilot Chat. Se o erro persistir, vá para a próxima correção.
Correção 2: Recarregar a Janela do VS Code
- Abra a Paleta de Comandos
Pressione Ctrl+Shift+P para abrir a Paleta de Comandos. - Execute o comando Recarregar Janela
Digite “Desenvolvedor: Recarregar Janela” e selecione-o na lista. O VS Code recarregará todas as extensões e a interface do editor sem reiniciar o aplicativo inteiro. - Teste a barra lateral
Pressione Ctrl+Shift+I. Se a barra lateral ainda exibir um erro, prossiga para a Correção 3.
Correção 3: Limpar o Cache da Extensão Copilot
- Feche o VS Code completamente
Saia do VS Code usando Arquivo > Sair ou fechando todas as janelas. - Abra a pasta de cache de extensões do VS Code
Abra o Explorador de Arquivos e navegue até este caminho: %USERPROFILE%\.vscode\extensions. Substitua %USERPROFILE% pela sua pasta de usuário real, por exemplo C:\Users\jdoe. - Exclua a pasta de cache do Copilot Chat
Procure por uma pasta chamada github.copilot-chat- seguida por um número de versão, por exemplo github.copilot-chat-0.23.0. Exclua essa pasta inteira. - Reinicie o VS Code
Abra o VS Code. A extensão Copilot Chat baixará novamente seus arquivos necessários automaticamente. - Teste a barra lateral
Pressione Ctrl+Shift+I. Se o erro continuar, vá para a Correção 4.
Correção 4: Atualizar o VS Code e Todas as Extensões
- Verifique se há atualizações do VS Code
No VS Code, abra Ajuda > Verificar Atualizações. Se houver uma atualização disponível, instale-a e reinicie o VS Code. - Atualize todas as extensões
Vá para o painel de Extensões (Ctrl+Shift+X). Clique no menu de três pontos no topo e selecione Verificar Atualizações de Extensões. Clique em Atualizar Tudo se houver atualizações disponíveis. - Reinicie o VS Code
Feche e reabra o VS Code. - Teste a barra lateral
Pressione Ctrl+Shift+I. Se o erro persistir, prossiga para a Correção 5.
Correção 5: Verificar Configurações de Rede e Firewall
- Verifique a conectividade com a internet
Abra um navegador e navegue até github.com. Se o site não carregar, resolva sua conexão de rede primeiro. - Desative temporariamente a VPN ou proxy
Se você usa VPN ou proxy, desconecte-se e teste a barra lateral do Copilot Chat. - Permita o VS Code no firewall
Se você usa o Firewall do Windows Defender, abra Segurança do Windows > Firewall e proteção de rede > Permitir um aplicativo através do firewall. Certifique-se de que Code.exe e Code – Insiders.exe estejam permitidos para redes privadas e públicas. - Teste a barra lateral
Pressione Ctrl+Shift+I. Se o erro ainda aparecer, entre em contato com sua equipe de TI para garantir que github.com e api.github.com não estejam bloqueados.
Se o Copilot Chat Ainda Tiver Problemas Após a Correção Principal
Barra Lateral do Copilot Chat Mostra “Faça login no GitHub” Mas Você Já Está Logado
Isso indica que o token de autenticação está ausente ou expirado. Abra a Paleta de Comandos (Ctrl+Shift+P), digite “GitHub: Sair” e selecione. Em seguida, faça login novamente usando “GitHub: Entrar”. Após fazer login, recarregue a janela usando Desenvolvedor: Recarregar Janela.
Barra Lateral do Copilot Chat Abre Mas Mostra uma Área Branca Vazia
Uma área branca vazia geralmente significa que o processo host do WebView travou. Feche o VS Code completamente e reabra. Se o problema se repetir, abra o painel de Extensões, encontre o GitHub Copilot Chat, clique no ícone de engrenagem e selecione Configurações da Extensão. Procure pela configuração “GitHub Copilot Chat: Webview Host” e altere para “iframe” em vez do padrão. Recarregue a janela.
Barra Lateral do Copilot Chat Retorna “Host da extensão encerrado inesperadamente”
Esse erro aponta para um conflito com outra extensão. Desative todas as extensões não Microsoft abrindo o painel de Extensões, clicando no menu de três pontos e selecionando Desativar Todas as Extensões Instaladas. Em seguida, ative apenas GitHub Copilot e GitHub Copilot Chat. Se a barra lateral funcionar, reative as extensões uma por uma para encontrar a conflitante.
Fontes de Erro na Barra Lateral do GitHub Copilot Chat: Comparação Rápida
| Sintoma do Erro | Causa Mais Provável | Correção Mais Rápida |
|---|---|---|
| Mensagem “Falha ao carregar” na barra lateral | Cache de extensão corrompido | Desativar e reativar a extensão |
| Área branca vazia na barra lateral | Travamento do host do WebView | Alterar o host do WebView para iframe nas configurações da extensão |
| Erro “Conexão recusada” | Firewall ou proxy bloqueando o GitHub | Permitir o VS Code no firewall ou desativar a VPN |
| Solicitação “Faça login no GitHub” mesmo já logado | Token de autenticação expirado | Sair e entrar novamente via Paleta de Comandos |
Agora você pode resolver erros na barra lateral do GitHub Copilot Chat desativando e reativando a extensão, recarregando a janela do VS Code ou limpando o cache local da extensão. Se a barra lateral ainda falhar, atualize o VS Code e todas as extensões, depois verifique as configurações de rede e firewall. Para problemas persistentes de barra lateral em branco, altere a configuração do host do WebView para iframe para evitar travamentos do processo host.