Por que a barra lateral do GitHub Copilot não abre no VS Code

Você instalou a extensão GitHub Copilot no Visual Studio Code, mas o painel da barra lateral não aparece ao clicar no ícone do Copilot. O ícone pode permanecer esmaecido ou o clique não produz resposta. Esse problema geralmente ocorre devido a conflitos de extensão, cache corrompido da extensão ou configurações incorretas do VS Code que bloqueiam a barra lateral de carregar. Este artigo explica as três causas raiz mais comuns e fornece correções passo a passo para restaurar a barra lateral do Copilot.

Por que a barra lateral do Copilot não carrega

A barra lateral do GitHub Copilot é um painel webview renderizado dentro do VS Code. Quando o painel não abre, a causa raiz é quase sempre um de três cenários: um conflito com outra extensão instalada, um cache local corrompido da extensão Copilot ou uma configuração do VS Code que impede a renderização da barra lateral. Entender essas causas ajuda você a aplicar a correção correta sem desabilitar extensões não relacionadas ou reinstalar o VS Code.

Conflitos de extensão

As extensões do VS Code são executadas em um processo de host de extensões compartilhado. Se outra extensão modificar os mesmos componentes de UI ou recursos webview, a barra lateral do Copilot pode falhar ao inicializar. Os culpados comuns incluem extensões de tema que substituem estilos de webview, extensões de atalhos de teclado que reatribuem o atalho do Copilot e versões antigas da extensão GitHub Pull Requests.

Cache de extensão corrompido

A extensão Copilot armazena tokens de autenticação, configuração do modelo e estado da UI em uma pasta de cache local. Se esse cache for corrompido devido a uma atualização incompleta ou erro de gravação em disco, a barra lateral não consegue carregar seu conteúdo inicial. O ícone aparece na barra de atividades, mas clicar nele não faz nada.

Configurações incorretas do VS Code

O VS Code tem uma configuração que controla a localização da barra lateral. Quando definida como “auto”, o VS Code pode falhar ao alocar um espaço para o webview do Copilot. Além disso, a configuração window.titleBarStyle definida como “custom” no Linux pode interferir na renderização do webview.

Passos para abrir a barra lateral do Copilot

Siga estes métodos em ordem. Teste a barra lateral após cada método antes de passar para o próximo.

Método 1: Recarregar a janela do VS Code

1. Abra a paleta de comandos
   Pressione Ctrl+Shift+P no Windows ou Linux, ou Cmd+Shift+P no macOS.
2. Execute o comando de recarregar
   Digite Developer: Reload Window e pressione Enter. O VS Code recarrega o host de extensões e todos os painéis de UI. A barra lateral do Copilot deve aparecer após o recarregamento.

Método 2: Verificar e alterar a configuração de localização da barra lateral

1. Abra as configurações do VS Code
   Pressione Ctrl+, (vírgula) no Windows e Linux, ou Cmd+, no macOS.
2. Pesquise pela configuração de localização da barra lateral
   Na barra de pesquisa das configurações, digite sidebar.location.
3. Defina o valor como “left” ou “right”
   Clique no menu suspenso e selecione “left” ou “right”. Não selecione “auto”. A barra lateral do Copilot requer uma atribuição explícita de lado.
4. Recarregue a janela
   Pressione Ctrl+Shift+P, execute Developer: Reload Window e verifique o ícone do Copilot na barra de atividades.

Método 3: Desabilitar extensões conflitantes

1. Abra a visualização de extensões
   Clique no ícone de Extensões na barra de atividades ou pressione Ctrl+Shift+X.
2. Desabilite todas as extensões exceto o Copilot
   Clique no ícone de engrenagem ao lado de cada extensão e selecione “Disable”. Deixe apenas GitHub Copilot e GitHub Copilot Chat habilitados.
3. Recarregue a janela
   Execute Developer: Reload Window na paleta de comandos.
4. Teste a barra lateral do Copilot
   Clique no ícone do Copilot. Se a barra lateral abrir, uma das extensões desabilitadas era a causa. Reabilite as extensões uma por uma, recarregando a cada vez, até que a barra lateral pare de funcionar novamente. A última extensão reabilitada é o conflito.

Método 4: Excluir o cache da extensão Copilot

1. Feche o VS Code completamente
   Saia de todas as janelas do VS Code. Verifique a bandeja do sistema para garantir que nenhum processo do VS Code permaneça em execução.
2. Abra a pasta de cache da extensão do VS Code
   No Windows, navegue até %USERPROFILE%\.vscode\extensions\github.copilot-\. No macOS e Linux, navegue até ~/.vscode/extensions/github.copilot-/. O nome exato da pasta inclui o número da versão, como github.copilot-1.200.0.
3. Exclua a subpasta de cache
   Dentro da pasta da extensão Copilot, exclua a pasta chamada cache ou .cache. Não exclua a pasta inteira da extensão.
4. Reinicie o VS Code
   Abra o VS Code. A extensão recria seu cache na inicialização. Clique no ícone do Copilot para verificar se a barra lateral abre.

Se o Copilot ainda tiver problemas após a correção principal

Ícone do Copilot ausente na barra de atividades

Se o ícone do Copilot não aparecer, a extensão pode não estar instalada corretamente. Abra a visualização de extensões, pesquise por “GitHub Copilot” e verifique se a extensão aparece como habilitada. Se aparecer como desabilitada, habilite-a e recarregue. Se aparecer como instalada mas acinzentada, reinstale a extensão clicando no ícone de engrenagem e selecionando “Install Another Version”, depois escolha a versão estável mais recente.

Barra lateral do Copilot abre mas mostra um painel branco vazio

Um painel branco vazio indica uma falha na renderização do webview. Isso geralmente acontece quando o VS Code não consegue carregar os recursos HTML ou JavaScript da extensão. A correção é limpar o cache de webview do VS Code. Pressione Ctrl+Shift+P, execute Developer: Clear Editor Cache e recarregue a janela. Se o problema persistir, verifique suas configurações de proxy. Vá em File > Preferences > Settings, pesquise por http.proxy e certifique-se de que a URL do proxy está correta. Um proxy incorreto bloqueia o webview de buscar recursos remotos.

Barra lateral do Copilot fecha imediatamente após abrir

Esse comportamento geralmente é causado por um conflito de atalhos de teclado. O atalho de teclado padrão para alternar o painel do Copilot é Ctrl+Shift+I no Windows e Linux, ou Cmd+Shift+I no macOS. Se outra extensão ou um atalho definido pelo usuário usar o mesmo atalho, o VS Code pode fechar o painel logo após abri-lo. Abra a paleta de comandos, execute Preferences: Open Keyboard Shortcuts, pesquise por Copilot e inspecione os atalhos. Remova ou altere quaisquer atalhos conflitantes.

Item	Barra lateral do Copilot não abre	Barra lateral do Copilot em branco
Causa principal	Conflito de extensão, cache corrompido ou localização da barra lateral definida como “auto”	Falha na renderização do webview devido a HTML em cache ou configuração incorreta de proxy
Correção rápida	Recarregar janela ou alterar localização da barra lateral para “left” ou “right”	Limpar cache do editor via paleta de comandos
Requer reinstalação da extensão?	Não, a menos que a extensão esteja desabilitada ou ausente	Não, a menos que limpar cache e verificar proxy falhem
Afetado por configurações de proxy?	Não	Sim

Após aplicar a correção correta, a barra lateral do Copilot deve abrir de forma confiável. Se a barra lateral ainda falhar, verifique os logs do VS Code em busca de erros específicos da extensão. Abra a paleta de comandos e execute Developer: Toggle Developer Tools. Na guia Console, procure mensagens de erro vermelhas contendo “copilot” ou “webview”. Pesquise o texto do erro no fórum da comunidade do GitHub Copilot para encontrar uma solução direcionada. Como último passo, redefina o VS Code para as configurações padrão executando Developer: Reset Window State na paleta de comandos. Isso limpa todas as personalizações específicas do espaço de trabalho sem remover extensões.