# Pulire la cache di VS Code su Mac senza azzerare tutto

> Distingui cache, pacchetti scaricati e stato delle aree di lavoro per pulire VS Code su Mac conservando impostazioni ed estensioni.

Published: 2026-10-28

Se VS Code occupa molto spazio o continua a funzionare male, non serve necessariamente azzerare tutto. Su Mac, la cartella `Code` mescola cache ricreabili, impostazioni, stato delle aree di lavoro e dati delle estensioni. Eliminarla interamente cambia molto più di una pulizia della cache. Parti dal ricaricamento della finestra o da una verifica delle estensioni, poi rimuovi solo la cache identificata.

## Distinguere il contenuto della cartella Code

La versione standard di Microsoft conserva i dati utente in `~/Library/Application Support/Code`. Impostazioni e stato del profilo predefinito sono sotto `User`, mentre le estensioni installate si trovano normalmente a parte in `~/.vscode/extensions`. Le opzioni di avvio possono cambiare questi percorsi. La [documentazione delle impostazioni](https://code.visualstudio.com/docs/configure/settings) indica il file di configurazione e l'[implementazione dell'ambiente](https://github.com/microsoft/vscode/blob/main/src/vs/platform/environment/common/environmentService.ts) separa archiviazione delle aree di lavoro, log e pacchetti delle estensioni scaricati.

I percorsi della prima colonna sono relativi a `~/Library/Application Support/Code`, tranne l'ultima riga.

| Posizione | Contenuto | Decisione |
| --- | --- | --- |
| `Cache`, `Code Cache`, `GPUCache` | Cache Chromium di risorse, codice compilato e grafica | Ricreabili, pulire solo dopo aver chiuso l'app |
| `CachedData` | Cache del codice di avvio di VS Code, distinta per build | Ricreabile, il prossimo avvio può essere più lento |
| `CachedExtensionVSIXs` | Pacchetti di installazione delle estensioni scaricati | Rimovibili, installazioni o aggiornamenti successivi potrebbero riscaricarli |
| `User/workspaceStorage` | Stato dell'editor e delle estensioni per area di lavoro | Conservare normalmente, esaminare le singole voci |
| `User/globalStorage` | Dati persistenti dell'editor e delle estensioni, eventualmente legati all'accesso | Conservare, non è una cache generica |
| `logs` | Diagnostica delle sessioni precedenti | Rimuovere le vecchie sessioni dopo la diagnosi |
| `User` | Impostazioni, tasti di scelta rapida, frammenti, profili e altro stato | Conservare, cronologia locale compresa |
| `~/.vscode/extensions` | Estensioni installate | Conservare, gestire dall'editor |

Electron descrive l'[archiviazione Chromium nei dati utente](https://www.electronjs.org/docs/latest/api/app#appgetpathname), con cache accanto a cookie e archiviazione locale. Cartelle vicine dal nome simile non sono automaticamente eliminabili. Sono dettagli implementativi, non la garanzia che ogni versione crei tutte le cartelle.

## Provare prima gli strumenti di VS Code

Salva i file, apri il riquadro comandi con Shift + Command + P ed esegui Developer: Reload Window. Ricarica la finestra, non è una procedura documentata di svuotamento della cache su disco. È un primo intervento limitato se l'interfaccia non si aggiorna. La sua [implementazione](https://github.com/microsoft/vscode/blob/main/src/vs/workbench/browser/actions/windowActions.ts) richiama proprio il ricaricamento della finestra.

Se il problema è iniziato dopo una modifica alle estensioni, disabilita quella coinvolta prima di cancellarne i dati. La [guida Microsoft ai problemi di prestazioni](https://github.com/microsoft/vscode/wiki/Performance-Issues) descrive Help: Start Extension Bisect, che disabilita gruppi di estensioni e chiede se il problema persiste. Identificata l'estensione, segui la sua procedura documentata di ripristino o ricostruzione. Nessuna pulizia comune può azzerare in sicurezza tutti i dati arbitrari delle estensioni.

## Misurare prima di spostare

Nel Finder premi Shift + Command + G e inserisci `~/Library/Application Support/Code`. Guarda le dimensioni delle singole cartelle, senza considerare l'intero totale come spazio recuperabile. Il Terminale può misurare senza modificare nulla:

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

La prima riga separa le cache principali da `User`, la seconda mostra se prevalgono i dati delle aree di lavoro o l'archiviazione globale. Non sommare cartella padre e sottocartelle. Un percorso mancante significa che quella posizione non esiste, un errore di autorizzazione indica una misurazione incompleta.

Questi percorsi riguardano l'installazione stabile standard. Se avvii con `--user-data-dir` o `--extensions-dir`, controlla invece le directory specificate. Il [riferimento della riga di comando](https://code.visualstudio.com/docs/configure/command-line) documenta entrambe le opzioni. Un ambiente di sviluppo remoto richiede un controllo separato: non presumere che i suoi dati siano in questa cartella locale.

## Pulire solo la parte ricreabile

1. Salva il lavoro, termina le attività del terminale integrato e chiudi completamente VS Code con Command + Q. Chiudere una finestra non equivale a uscire dall'app.
2. Prima di sperimentare sullo stato, fai una copia di `User` e conserva separatamente ciò che un'estensione non può ricreare. Mantieni le cartelle dei progetti e la loro configurazione `.vscode`.
3. Apri `Code` nel Finder e sposta nel Cestino solo la cartella identificata `Cache`, `Code Cache`, `GPUCache` o `CachedData`. Inizia da quella pertinente e verifica, senza cancellare tutte le cartelle vicine.
4. Esamina separatamente `CachedExtensionVSIXs` se lo spazio è occupato dai download. Contiene archivi di installazione, non le estensioni installate. Salva altrove eventuali installer offline insostituibili. Il [downloader delle estensioni](https://github.com/microsoft/vscode/blob/main/src/vs/platform/extensionManagement/node/extensionDownloader.ts) riutilizza i pacchetti presenti o scarica quelli mancanti.
5. Le vecchie sessioni di `logs` sono una pulizia facoltativa quando non servono più per la diagnosi. Le nuove sessioni scrivono nuovi log, ma la cronologia diagnostica cancellata non viene ricostruita.

Riapri lo stesso progetto e verifica il problema originale prima di svuotare il Cestino. Le cache possono tornare con l'uso delle risorse e il primo avvio può richiedere più tempo. È una normale ricostruzione, non la prova che la pulizia sia fallita.

## Trattare l'archiviazione delle aree di lavoro come stato

`User/workspaceStorage` contiene cartelle identificate dagli ID delle aree di lavoro. L'[implementazione Microsoft](https://github.com/microsoft/vscode/blob/main/src/vs/platform/storage/electron-main/storageMain.ts) scrive `state.vscdb` e `workspace.json`; anche le estensioni possono salvarvi file specifici dell'area. Una voce grande può contenere stato locale utile, incluse conversazioni delle estensioni, non soltanto un indice.

Leggi il `workspace.json` di una voce per identificarne la cartella o l'area di lavoro. Può rimanere dopo lo spostamento o la cancellazione del progetto, ma la cartella potrebbe anche trovarsi su un disco non montato. Verifica quale caso si applica, copia la voce, chiudi VS Code e solo allora valuta di eliminare quella singola voce. I file del progetto sono separati, ma riaprirli non ripristina automaticamente lo stato perso dell'area o delle estensioni. Conserva le voci remote o non riconosciute.

Mantieni `User/globalStorage`. Azzerarlo può rimuovere dati persistenti delle estensioni e richiedere un nuovo accesso, con effetti diversi secondo l'estensione e la versione di VS Code. Conservare solo `settings.json` non protegge tutto questo stato.

## Verificare lo spazio e i problemi rimasti

Ripeti le stesse misurazioni dopo aver riaperto e usato il progetto. I file nel Cestino continuano a occupare disco fino alla loro rimozione: una cartella `Code` più piccola non significa subito più spazio libero. Mantieni la possibilità di recupero finché non hai verificato impostazioni, estensioni e sintomo originale.

Se il problema persiste, prova un'istanza isolata con directory nuove e mai usate:

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

Questo crea dati di prova senza azzerare la configurazione abituale. Se `code` non è disponibile, segui la configurazione macOS collegata nel riferimento della riga di comando. Non attivare Settings Sync e non installare estensioni prima del primo confronto. Se l'istanza pulita funziona, c'è una differenza nel profilo o nelle estensioni abituali, non necessariamente una cache corrotta. Se dopo la pulizia hai perso l'accesso, smetti di cancellare, controlla quali cartelle di stato hai spostato e, quando opportuno, ripristina la copia con VS Code chiuso.

## Il ruolo di Mole

In Pulizia, Mole Mac elenca `CachedData`, `Code Cache`, `GPUCache` e le sottocartelle esistenti `WebStorage/<id>/CacheStorage`, selezionate per impostazione predefinita quando disponibili. Le voci di Application Support richiedono Accesso completo al disco; VS Code aperto blocca le righe pertinenti fino alla chiusura. Le voci orfane di `User/workspaceStorage` la cui cartella locale non esiste più sono solo da esaminare e inizialmente non selezionate. Non pulire mai questo tipo esclude quella regola VS Code, comprese le corrispondenze future. Queste righe non puntano a impostazioni, archiviazione globale o estensioni attive. Eliminazione cache usa normalmente Elimina definitivamente, anche per queste voci di area di lavoro, prive di un'eccezione che imponga il Cestino. Per consentire il recupero scegli Sposta nel Cestino in Eliminazione cache. La [guida dell'app testata VS Code](https://mole.fit/tested-apps/vscode) riguarda l'elenco separato di disinstallazione.

Per rimuovere l'editor consulta [Disinstallare VS Code su Mac](https://mole.fit/it/blog/how-to-uninstall-vscode-mac). Le cache dei gestori di pacchetti e delle build dei progetti sono nella [guida alle cache di sviluppo](https://mole.fit/it/blog/how-to-clear-dev-caches-mac).

## Domande frequenti

### Verranno eliminate impostazioni o estensioni?

I passaggi limitati alle cache mantengono `User` e `~/.vscode/extensions`. Eliminare tutta `Code` azzera i dati utente ed è un'altra operazione, come spiega la [documentazione di disinstallazione](https://code.visualstudio.com/docs/setup/uninstall) di Microsoft.

### Perché la cache cresce di nuovo?

VS Code ricrea le cache di codice e grafica durante l'uso. Gli archivi delle estensioni mancanti possono essere scaricati durante installazioni o aggiornamenti successivi. Cancellarli ripetutamente non risolve un'estensione che continua a generare troppi dati.

### Posso eliminare tutta l'archiviazione delle aree di lavoro?

Perderesti lo stato locale di tutte le aree salvate. Esamina le voci singolarmente e mantieni copie di sicurezza. Una cartella ricreata all'avvio non significa che il contenuto precedente sia stato recuperato.

---

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