Limpar o cache do VS Code no Mac sem redefinir tudo

O VS Code pode ocupar muito espaço ou continuar apresentando problemas sem precisar de uma redefinição completa. No Mac, a pasta Code mistura caches que podem ser recriados com configurações, estado dos espaços de trabalho e dados de extensões. Apagar a pasta inteira muda muito mais do que limpar um cache. Comece recarregando a janela ou verificando as extensões e depois remova apenas o cache identificado.

Entenda o conteúdo da pasta Code

A versão padrão da Microsoft guarda os dados do usuário em ~/Library/Application Support/Code. As configurações e o estado do perfil padrão ficam em User, enquanto as extensões instaladas normalmente ficam separadas em ~/.vscode/extensions. Opções de inicialização podem mudar esses locais. A documentação de configurações identifica o arquivo de ajustes, e a implementação do ambiente separa armazenamento de espaços de trabalho, logs e pacotes de extensões baixados.

Os caminhos da primeira coluna são relativos a ~/Library/Application Support/Code, exceto na última linha.

O Electron documenta o armazenamento Chromium nos dados do usuário, com caches ao lado de cookies e armazenamento local. Pastas vizinhas com nomes parecidos não estão automaticamente liberadas para exclusão. São detalhes de implementação, não uma promessa de que toda versão cria todas as pastas.

Tente primeiro os recursos do VS Code

Salve os arquivos, abra a Paleta de Comandos com Shift + Command + P e execute Developer: Reload Window. Isso recarrega a janela, não é uma limpeza documentada do cache em disco. É um primeiro passo menor quando a interface não se atualiza. A implementação chama justamente a operação de recarregar a janela.

Se o problema começou após uma mudança em uma extensão, tente desativá-la antes de apagar seus dados. O guia de problemas de desempenho descreve Help: Start Extension Bisect, que desativa grupos de extensões e pergunta se o problema continua. Ao identificar a responsável, siga sua ação documentada de redefinição ou reconstrução. Não existe uma operação comum de cache que redefina com segurança todos os dados arbitrários das extensões.

Meça antes de mover

No Finder, pressione Shift + Command + G e digite ~/Library/Application Support/Code. Veja o tamanho de cada pasta em vez de considerar todo o total como espaço recuperável. No Terminal, estes comandos medem sem alterar nada:

du -sh "$HOME/Library/Application Support/Code"/*
du -sh "$HOME/Library/Application Support/Code/User"/* "$HOME/.vscode/extensions"

A primeira linha separa os caches da raiz de User; a segunda mostra se o armazenamento dos espaços de trabalho ou o global responde pela maior parte. Não some a pasta pai e suas subpastas. Uma mensagem de caminho inexistente significa que aquele local não existe, enquanto um erro de permissão indica medição incompleta.

Esses caminhos são da instalação estável padrão. Se você inicia com --user-data-dir ou --extensions-dir, examine os diretórios especificados. A referência da linha de comando documenta as duas opções. Um ambiente de desenvolvimento remoto precisa de investigação própria, sem presumir que seus dados estejam nessa pasta local.

Limpe apenas a parte que pode ser recriada

1. Salve o trabalho, termine as tarefas no terminal integrado e encerre completamente o VS Code com Command + Q. Fechar uma janela não equivale a encerrar o app.
2. Faça backup de User antes de testar mudanças no estado e guarde separadamente o que uma extensão não puder recriar. Preserve as pastas dos projetos e suas configurações .vscode.
3. Abra Code no Finder e mova para o Lixo apenas a pasta identificada Cache, Code Cache, GPUCache ou CachedData. Comece pela relacionada ao problema e teste, em vez de remover todas as vizinhas.
4. Analise CachedExtensionVSIXs separadamente se os downloads ocuparem o espaço. São arquivos de instalação, não extensões instaladas. Guarde em outro lugar qualquer instalador offline que não possa obter novamente. O baixador de extensões reutiliza pacotes existentes ou baixa os ausentes.
5. Sessões antigas de logs podem ser removidas quando os registros de diagnóstico não forem mais necessários. Novas sessões escrevem novos logs, mas o histórico apagado não será recriado.

Reabra o mesmo projeto e verifique o problema original antes de esvaziar o Lixo. Os caches podem voltar conforme os recursos são usados, e a primeira inicialização pode demorar mais. Isso é reconstrução normal, não prova de falha na limpeza.

Trate o armazenamento dos espaços de trabalho como estado

User/workspaceStorage contém pastas identificadas por IDs de espaços de trabalho. A implementação da Microsoft grava state.vscdb e workspace.json; extensões também podem guardar arquivos específicos ali. Uma entrada grande pode conter estado local útil, incluindo conversas de extensões, e não apenas um índice.

Leia o workspace.json da entrada para identificar sua pasta ou espaço de trabalho. Ela pode permanecer depois que um projeto é apagado ou movido, mas a pasta ausente também pode estar em um disco não montado. Confirme o caso, faça backup da entrada, encerre o VS Code e só então considere remover aquela entrada. Os arquivos do projeto são separados, mas reabri-los não restaura automaticamente o estado perdido do espaço ou das extensões. Mantenha entradas remotas ou não reconhecidas.

Preserve User/globalStorage. Redefini-lo pode apagar dados persistentes de extensões e exigir um novo login, com efeitos que variam por extensão e versão do VS Code. Guardar apenas settings.json não preserva todo esse estado.

Confira o espaço e investigue o que restar

Repita as mesmas medições depois de reabrir e usar o projeto. Os arquivos no Lixo ainda ocupam disco até serem removidos, então uma pasta Code menor não significa mais espaço livre imediatamente. Mantenha a possibilidade de recuperação até conferir configurações, extensões e o sintoma original.

Se o problema continuar, experimente uma instância isolada com diretórios novos e ainda não usados:

code --user-data-dir "$HOME/vscode-cache-test-data" --extensions-dir "$HOME/vscode-cache-test-extensions"

Isso cria dados de teste sem redefinir a configuração habitual. Se code não estiver disponível, siga a configuração do macOS vinculada na referência da linha de comando. Não ative Settings Sync nem instale extensões antes da primeira comparação. Uma instância limpa funcionando aponta para uma diferença no perfil ou nas extensões habituais, não necessariamente para um cache corrompido. Se o login sumiu após a limpeza, pare de apagar, confira quais pastas de estado foram movidas e restaure o backup quando adequado, com o VS Code encerrado.

Onde o Mole entra

Em Limpar, o Mole Mac lista CachedData, Code Cache, GPUCache e as subpastas existentes WebStorage/<id>/CacheStorage, selecionadas por padrão quando disponíveis. As entradas de Application Support exigem Acesso Total ao Disco, e o VS Code aberto bloqueia as linhas relacionadas até ser encerrado. As entradas órfãs de User/workspaceStorage cuja pasta local não existe mais são para revisão e começam desmarcadas. Nunca limpar este tipo exclui essa regra do VS Code, incluindo correspondências futuras. Essas linhas não têm como alvo configurações, armazenamento global ou extensões ativas. Exclusão de caches usa por padrão Excluir permanentemente, inclusive para essas entradas de espaços de trabalho sem exceção que imponha o Lixo. Para permitir recuperação, escolha Mover para o Lixo em Exclusão de caches. O guia do app testado VS Code trata da lista separada de desinstalação.

Para remover o editor, consulte Desinstalar o VS Code no Mac. Caches de gerenciadores de pacotes e de build dos projetos estão no guia de caches de desenvolvimento.

Perguntas frequentes

Isso remove minhas configurações ou extensões?

As etapas limitadas aos caches preservam User e ~/.vscode/extensions. Remover toda a pasta Code redefine os dados do usuário e é outra operação, como explica a documentação de desinstalação da Microsoft.

Por que o cache cresce de novo?

O VS Code recria caches de código e gráficos durante o uso. Arquivos de extensões ausentes podem ser baixados em instalações ou atualizações futuras. Apagá-los repetidamente não corrige uma extensão que continua gerando dados demais.

Posso apagar todo o armazenamento dos espaços de trabalho?

Isso descarta o estado local de todos os espaços salvos. Examine as entradas individualmente e mantenha backups. Uma pasta recriada na inicialização não significa que o conteúdo anterior foi recuperado.