# Limpar o cache do VS Code no Mac sem redefinir tudo

> Separe caches, pacotes baixados e estado dos espaços de trabalho para limpar o VS Code no Mac sem apagar sua configuração.

Published: 2026-10-28

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](https://code.visualstudio.com/docs/configure/settings) identifica o arquivo de ajustes, e a [implementação do ambiente](https://github.com/microsoft/vscode/blob/main/src/vs/platform/environment/common/environmentService.ts) 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.

| Local | Conteúdo | Decisão |
| --- | --- | --- |
| `Cache`, `Code Cache`, `GPUCache` | Caches Chromium de recursos, código compilado e gráficos | Recriáveis, limpar apenas depois de encerrar o app |
| `CachedData` | Cache de código de inicialização do VS Code, separado por build | Recriável, a próxima inicialização pode demorar mais |
| `CachedExtensionVSIXs` | Pacotes de instalação de extensões baixados | Removíveis, instalações ou atualizações futuras podem baixá-los de novo |
| `User/workspaceStorage` | Estado do editor e das extensões por espaço de trabalho | Manter por padrão, analisar cada entrada |
| `User/globalStorage` | Dados persistentes do editor e das extensões, possivelmente ligados ao login | Manter, não é um cache genérico |
| `logs` | Registros de diagnóstico de sessões anteriores | Remover sessões antigas depois da investigação |
| `User` | Configurações, atalhos, snippets, perfis e outros estados | Manter, incluindo o histórico local |
| `~/.vscode/extensions` | Extensões instaladas | Manter, gerenciar pelo editor |

O Electron documenta o [armazenamento Chromium nos dados do usuário](https://www.electronjs.org/docs/latest/api/app#appgetpathname), 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](https://github.com/microsoft/vscode/blob/main/src/vs/workbench/browser/actions/windowActions.ts) 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](https://github.com/microsoft/vscode/wiki/Performance-Issues) 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:

```sh
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](https://code.visualstudio.com/docs/configure/command-line) 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](https://github.com/microsoft/vscode/blob/main/src/vs/platform/extensionManagement/node/extensionDownloader.ts) 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](https://github.com/microsoft/vscode/blob/main/src/vs/platform/storage/electron-main/storageMain.ts) 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:

```sh
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](https://mole.fit/tested-apps/vscode) trata da lista separada de desinstalação.

Para remover o editor, consulte [Desinstalar o VS Code no Mac](https://mole.fit/pt-br/blog/how-to-uninstall-vscode-mac). Caches de gerenciadores de pacotes e de build dos projetos estão no [guia de caches de desenvolvimento](https://mole.fit/pt-br/blog/how-to-clear-dev-caches-mac).

## 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](https://code.visualstudio.com/docs/setup/uninstall) 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.

---

Canonical HTML page: https://mole.fit/pt-br/blog/clear-vscode-cache-mac
Blog index for agents: https://mole.fit/pt-br/blog/llms.txt
Site index for agents: https://mole.fit/llms.txt