# Vider le cache de VS Code sur Mac sans tout réinitialiser

> Repérez les caches de VS Code sur Mac et videz uniquement les données recréables en conservant réglages et extensions.

Published: 2026-10-28

VS Code peut occuper beaucoup de place ou mal fonctionner sans nécessiter une réinitialisation complète. Sur Mac, le dossier `Code` mélange caches recréables, réglages, état des espaces de travail et données des extensions. Le supprimer entièrement change donc bien plus qu'un nettoyage du cache. Commencez par recharger la fenêtre ou vérifier les extensions, puis retirez uniquement le cache identifié.

## Reconnaître le contenu du dossier Code

La version standard de Microsoft conserve les données utilisateur dans `~/Library/Application Support/Code`. Les réglages et l'état du profil par défaut se trouvent sous `User`, les extensions installées généralement à part dans `~/.vscode/extensions`. Des options de lancement peuvent modifier ces emplacements. La [documentation des réglages](https://code.visualstudio.com/docs/configure/settings) indique le fichier de configuration, et l'[implémentation de l'environnement](https://github.com/microsoft/vscode/blob/main/src/vs/platform/environment/common/environmentService.ts) distingue stockage des espaces de travail, journaux et paquets d'extensions téléchargés.

La première colonne donne des chemins relatifs à `~/Library/Application Support/Code`, sauf à la dernière ligne.

| Emplacement | Contenu | Décision |
| --- | --- | --- |
| `Cache`, `Code Cache`, `GPUCache` | Caches Chromium de ressources, de code compilé et de graphismes | Recréables, à vider après avoir quitté l'app |
| `CachedData` | Cache de code au démarrage de VS Code, séparé par build | Recréable, prochain démarrage parfois plus lent |
| `CachedExtensionVSIXs` | Paquets d'installation d'extensions téléchargés | Supprimables, téléchargements possibles lors d'installations ou mises à jour ultérieures |
| `User/workspaceStorage` | État de l'éditeur et des extensions par espace de travail | Conserver par défaut, examiner chaque entrée |
| `User/globalStorage` | Données persistantes de l'éditeur et des extensions, parfois liées à la connexion | Conserver, ce n'est pas un cache général |
| `logs` | Diagnostics des sessions précédentes | Supprimer les anciennes sessions après le dépannage |
| `User` | Réglages, raccourcis, extraits, profils et autres états | Conserver, historique local compris |
| `~/.vscode/extensions` | Extensions installées | Conserver, gérer depuis l'éditeur |

Electron décrit le [stockage Chromium dans les données utilisateur](https://www.electronjs.org/docs/latest/api/app#appgetpathname), où les caches côtoient cookies et stockage local. Des dossiers voisins aux noms similaires ne sont pas pour autant à supprimer. Il s'agit de détails d'implémentation, pas d'une garantie que toutes les versions créent chaque dossier.

## Essayer d'abord les outils de VS Code

Enregistrez vos fichiers, ouvrez la palette avec Shift + Command + P et lancez Developer: Reload Window. Cette commande recharge la fenêtre, ce n'est pas une purge documentée du cache disque. C'est une première intervention limitée pour une interface qui ne s'actualise plus. Son [implémentation](https://github.com/microsoft/vscode/blob/main/src/vs/workbench/browser/actions/windowActions.ts) appelle bien le rechargement de la fenêtre.

Si le problème est apparu après une modification d'extension, désactivez celle-ci avant de supprimer ses données. Le [guide de diagnostic des performances](https://github.com/microsoft/vscode/wiki/Performance-Issues) présente Help: Start Extension Bisect, qui désactive des groupes d'extensions et vous demande si le problème persiste. Une fois l'extension identifiée, utilisez sa procédure documentée de réinitialisation ou de reconstruction. Aucune opération commune de nettoyage ne peut réinitialiser sans risque toutes les données arbitraires des extensions.

## Mesurer avant de déplacer

Dans le Finder, appuyez sur Shift + Command + G et saisissez `~/Library/Application Support/Code`. Examinez la taille de chaque dossier au lieu de considérer tout le total comme récupérable. Ces commandes du Terminal mesurent sans modifier les données :

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

La première ligne distingue les caches à la racine de `User`, la seconde montre si le stockage des espaces de travail ou le stockage global domine. N'additionnez pas le parent et ses enfants. Un message de chemin absent signifie que cet emplacement n'existe pas, une erreur d'autorisation que la mesure est incomplète.

Ces chemins concernent l'installation stable standard. Avec `--user-data-dir` ou `--extensions-dir`, examinez les répertoires indiqués à la place. La [référence de la ligne de commande](https://code.visualstudio.com/docs/configure/command-line) décrit les deux options. Un environnement de développement distant demande une enquête séparée, ses données ne sont pas nécessairement dans ce dossier local.

## Vider uniquement ce qui peut être recréé

1. Enregistrez le travail, terminez les tâches du terminal intégré et quittez complètement VS Code avec Command + Q. Fermer une fenêtre ne revient pas à quitter l'app.
2. Sauvegardez `User` avant toute expérience sur l'état et conservez séparément ce qu'une extension ne peut pas recréer. Gardez les projets et leur configuration `.vscode`.
3. Ouvrez `Code` dans le Finder et placez uniquement le dossier identifié `Cache`, `Code Cache`, `GPUCache` ou `CachedData` dans la corbeille. Commencez par celui qui est concerné, puis testez, sans supprimer ses voisins.
4. Examinez séparément `CachedExtensionVSIXs` si les téléchargements occupent l'espace. Ce sont des archives d'installation, pas les extensions installées. Gardez ailleurs tout installateur hors ligne irremplaçable. Le [téléchargeur d'extensions](https://github.com/microsoft/vscode/blob/main/src/vs/platform/extensionManagement/node/extensionDownloader.ts) réutilise les paquets présents ou télécharge ceux qui manquent.
5. Vous pouvez retirer les anciennes sessions de `logs` lorsque leurs éléments de diagnostic ne sont plus utiles. De nouvelles sessions écriront de nouveaux journaux, mais l'historique supprimé ne sera pas recréé.

Rouvrez le même projet et vérifiez le problème initial avant de vider la corbeille. Les caches reviennent à mesure que les ressources sont utilisées, et le premier démarrage peut être plus lent. Cette reconstruction normale ne prouve pas un échec du nettoyage.

## Traiter le stockage des espaces de travail comme un état

`User/workspaceStorage` contient des dossiers nommés par identifiant d'espace de travail. L'[implémentation Microsoft](https://github.com/microsoft/vscode/blob/main/src/vs/platform/storage/electron-main/storageMain.ts) y écrit `state.vscdb` et `workspace.json` ; les extensions peuvent aussi y enregistrer des fichiers propres à l'espace. Une grosse entrée peut contenir un état local utile, notamment des conversations d'extensions, et pas seulement un index.

Lisez le `workspace.json` d'une entrée pour retrouver son dossier ou son espace de travail. Elle peut subsister après un déplacement ou une suppression du projet, mais le dossier peut aussi être sur un disque non monté. Vérifiez la situation, sauvegardez l'entrée, quittez VS Code, puis envisagez de supprimer cette seule entrée. Les fichiers du projet sont séparés, mais rouvrir le projet ne restaure pas l'état perdu de l'espace ou des extensions. Conservez les entrées distantes ou non identifiées.

Gardez `User/globalStorage`. Le réinitialiser peut effacer des données persistantes d'extensions et imposer une nouvelle connexion, selon l'extension et la version de VS Code. Conserver seulement `settings.json` ne protège pas tout cet état.

## Vérifier l'espace et poursuivre le diagnostic

Refaites les mêmes mesures après avoir rouvert et utilisé le projet. Les fichiers dans la corbeille occupent encore du disque jusqu'à leur suppression, donc un dossier `Code` réduit ne signifie pas immédiatement plus d'espace libre. Préservez la possibilité de restaurer jusqu'à avoir vérifié réglages, extensions et symptôme initial.

Si le problème persiste, essayez une instance isolée avec des répertoires neufs et inutilisés :

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

Cela crée des données de test sans réinitialiser votre installation habituelle. Si `code` est introuvable, suivez la configuration macOS liée depuis la référence de la ligne de commande. N'activez pas Settings Sync et n'installez pas d'extensions avant la première comparaison. Une instance vierge qui fonctionne indique une différence avec le profil ou les extensions habituels, pas nécessairement un cache corrompu. Si la connexion a disparu après le nettoyage, arrêtez de supprimer, vérifiez quels dossiers d'état ont été déplacés et restaurez la sauvegarde si nécessaire, VS Code fermé.

## Ce que fait Mole

Dans Nettoyer, Mole Mac liste `CachedData`, `Code Cache`, `GPUCache` et les sous-dossiers existants `WebStorage/<id>/CacheStorage`, cochés par défaut lorsqu'ils sont disponibles. Les entrées Application Support nécessitent l'accès complet au disque, et VS Code en cours d'exécution bloque les lignes concernées jusqu'à sa fermeture. Les entrées orphelines de `User/workspaceStorage` dont le dossier local n'existe plus sont à examiner et décochées au départ. Ne jamais nettoyer ce type exclut cette règle VS Code, y compris pour les futurs résultats. Ces lignes ne ciblent pas les réglages, le stockage global ou les extensions actives. Suppression des caches utilise par défaut Supprimer définitivement, également pour ces entrées d'espace de travail sans exception imposant la corbeille. Choisissez Placer dans la corbeille dans Suppression des caches pour pouvoir restaurer. Le [guide de l'app testée VS Code](https://mole.fit/tested-apps/vscode) traite la liste distincte de désinstallation.

Pour enlever l'éditeur, consultez [Désinstaller VS Code sur Mac](https://mole.fit/fr/blog/how-to-uninstall-vscode-mac). Les caches de gestionnaires de paquets et de compilation relèvent du [guide des caches de développement](https://mole.fit/fr/blog/how-to-clear-dev-caches-mac).

## FAQ

### Mes réglages ou mes extensions seront-ils supprimés ?

Les étapes limitées aux caches conservent `User` et `~/.vscode/extensions`. Supprimer tout `Code` réinitialise les données utilisateur, c'est une autre opération, expliquée dans la [documentation de désinstallation](https://code.visualstudio.com/docs/setup/uninstall).

### Pourquoi le cache grossit-il à nouveau ?

VS Code recrée les caches de code et de graphismes pendant l'utilisation. Des archives d'extensions manquantes peuvent être téléchargées lors d'installations ou mises à jour ultérieures. Les supprimer sans cesse ne répare pas une extension qui génère trop de données.

### Puis-je supprimer tout le stockage des espaces de travail ?

Vous perdrez l'état local de tous les espaces enregistrés. Examinez les entrées séparément et gardez des sauvegardes. Un dossier recréé au lancement ne signifie pas que son ancien contenu a été restauré.

---

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