Como Redefinir o Cache Local do GitHub Copilot no VS Code

O GitHub Copilot no VS Code armazena um cache local de sugestões, tokens de autenticação e dados do modelo para acelerar as respostas. Com o tempo, esse cache pode ser corrompido ou ficar desatualizado, fazendo com que o Copilot sugira trechos de código irrelevantes, falhe ao ativar ou retorne erros como “GitHub Copilot could not connect.” Redefinir o cache local força o Copilot a reconstruir seu índice de sugestões e reautenticar com o servidor do GitHub.

Este artigo explica o que é o cache local, por que ele precisa ser redefinido e como excluí-lo passo a passo no VS Code no Windows, macOS e Linux. Você também aprenderá a limpar o cache sem desinstalar a extensão e a verificar se a redefinição funcionou.

O que o cache local do GitHub Copilot armazena e por que ele falha

A extensão GitHub Copilot para VS Code mantém um cache local para reduzir requisições de rede e acelerar a geração de sugestões. Esse cache inclui:

• Tokens de autenticação: Sua sessão de login e token do GitHub para que você não precise fazer login toda vez que abrir o VS Code.
• Contexto do modelo: Trechos de código vistos recentemente e contexto de arquivo que o Copilot usa para gerar sugestões relevantes.
• Estado da extensão: Configurações, estado ativado/desativado e modelos de linguagem usados por último.

O cache pode ser corrompido quando o VS Code é atualizado, quando a extensão do Copilot é atualizada ou quando seu token do GitHub expira. Um cache corrompido faz com que o Copilot pare de responder, sugira código desatualizado ou não carregue. Redefinir o cache força o Copilot a descartar todos os dados armazenados e baixar novo contexto de modelo e tokens de autenticação do servidor.

Passos para redefinir o cache local do GitHub Copilot no VS Code

Você pode redefinir o cache usando três métodos. Use o primeiro método se o Copilot ainda estiver funcionando parcialmente. Use o segundo método se o Copilot estiver completamente sem resposta. Use o terceiro método se quiser um estado limpo sem afetar outras extensões.

Método 1: Usar o comando Developer: Reload Window

Este método limpa o cache em memória e recarrega todas as extensões sem excluir nenhum arquivo.

1. Abra a paleta de comandos
   Pressione Ctrl+Shift+P no Windows ou Linux, ou Cmd+Shift+P no macOS.
2. Execute o comando Reload Window
   Digite Developer: Reload Window na paleta de comandos e pressione Enter.
3. Aguarde o VS Code recarregar
   O VS Code fecha e reabre todas as janelas e extensões. O ícone de status do Copilot no canto inferior direito deve ficar verde.

Método 2: Excluir manualmente a pasta de cache do Copilot

Este método remove todos os dados de sugestão em cache e força o Copilot a reconstruir seu índice de sugestões do zero.

1. Feche o VS Code completamente
   Saia do VS Code para evitar bloqueios de arquivo na pasta de cache.
2. Abra o local da pasta de cache
   No Windows, abra o File Explorer e cole %APPDATA%\Code\CachedData\ na barra de endereços. No macOS, abra o Finder e pressione Cmd+Shift+G, depois cole ~/Library/Application Support/Code/CachedData/. No Linux, abra seu gerenciador de arquivos e navegue até ~/.config/Code/CachedData/.
3. Exclua todos os arquivos e subpastas
   Selecione todos os itens dentro da pasta CachedData e pressione Delete. Talvez seja necessário confirmar a exclusão.
4. Reinicie o VS Code
   Abra o VS Code. A extensão Copilot reconstruirá o cache automaticamente.

Método 3: Sair e entrar novamente no GitHub

Este método limpa o cache do token de autenticação e força o Copilot a reautenticar.

1. Abra o menu de status do Copilot
   Clique no ícone do Copilot no canto inferior direito da janela do VS Code.
2. Selecione Sair
   Escolha Sign out of GitHub Copilot no menu.
3. Faça login novamente
   Clique no ícone do Copilot novamente e selecione Sign in to GitHub Copilot. Uma janela do navegador será aberta solicitando autorização do GitHub. Conclua o processo de login.

Se o Copilot ainda tiver problemas após redefinir o cache

Redefinir o cache geralmente resolve a maioria dos problemas do Copilot, mas alguns problemas exigem etapas adicionais.

Copilot ainda mostra “Not Authenticated” após fazer login

Isso acontece quando o arquivo de token em cache está bloqueado por outro processo. Feche o VS Code, exclua a pasta %APPDATA%\Code\User\globalStorage\github.copilot no Windows ou o caminho equivalente no macOS e Linux, depois reinicie o VS Code e faça login novamente.

Copilot sugere código no idioma errado

Isso indica que o cache de contexto do modelo está desatualizado. Use o Método 2 para excluir toda a pasta CachedData. Em seguida, abra um arquivo no idioma correto e deixe o Copilot gerar algumas sugestões para reconstruir o contexto.

A extensão Copilot não carrega após redefinir o cache

A extensão em si pode estar desabilitada ou corrompida. Abra a visualização de Extensões pressionando Ctrl+Shift+X, pesquise por “GitHub Copilot” e verifique se está habilitada. Se estiver habilitada mas ainda não carregar, desabilite-a, recarregue a janela e habilite-a novamente.

VS Code Reload Window vs Exclusão Manual de Cache: Principais Diferenças

Item	Reload Window	Exclusão Manual de Cache
Escopo	Limpa apenas o cache em memória	Exclui todos os arquivos de sugestão em cache
Efeito nas extensões	Recarrega todas as extensões	Não recarrega extensões automaticamente
Tokens de autenticação	Preservados	Preservados, a menos que você exclua a pasta do Copilot
Tempo para concluir	10 segundos	2 minutos
Quando usar	Copilot está lento ou não responde	Copilot sugere código desatualizado ou irrelevante

Escolha Reload Window para problemas rápidos de memória. Use a exclusão manual de cache quando o Copilot gerar sugestões desatualizadas ou erradas.

Agora você pode redefinir o cache local do GitHub Copilot no VS Code usando o comando Developer: Reload Window, exclusão manual de pasta ou o método de sair e entrar. Para problemas persistentes, exclua a pasta github.copilot no diretório globalStorage para limpar todos os dados de autenticação e estado. Como dica avançada, você pode automatizar a exclusão manual do cache criando um script em lote ou shell que exclua a pasta CachedData antes de iniciar o VS Code.