Limpiar la caché de VS Code en Mac sin restablecerlo todo

VS Code puede ocupar mucho espacio o seguir fallando sin necesitar un restablecimiento completo. En Mac, la carpeta Code mezcla cachés que se regeneran con ajustes, estado de los espacios de trabajo y datos de extensiones. Borrar toda la carpeta cambia mucho más que limpiar una caché. Empieza por recargar la ventana o revisar las extensiones y después elimina solo la caché identificada.

Distinguir el contenido de la carpeta Code

La versión estándar de Microsoft guarda los datos de usuario en ~/Library/Application Support/Code. Los ajustes y el estado del perfil predeterminado están bajo User, mientras que las extensiones instaladas suelen estar aparte en ~/.vscode/extensions. Las opciones de inicio pueden cambiar estas ubicaciones. La documentación de ajustes identifica el archivo de configuración y la implementación del entorno separa almacenamiento de espacios de trabajo, registros y paquetes de extensiones descargados.

La primera columna contiene rutas relativas a ~/Library/Application Support/Code, salvo la última fila.

Electron documenta el almacenamiento Chromium dentro de los datos de usuario, con cachés junto a cookies y almacenamiento local. Que las carpetas vecinas se parezcan no permite borrarlas todas. Son detalles de implementación, no una garantía de que cada versión cree todas las carpetas.

Probar primero las herramientas de VS Code

Guarda los archivos, abre la paleta con Shift + Command + P y ejecuta Developer: Reload Window. Recarga la ventana, no es una limpieza documentada de la caché del disco. Es una primera intervención pequeña si la interfaz no se actualiza. Su implementación llama a la operación de recarga de ventana.

Si el fallo empezó tras cambiar una extensión, prueba a desactivarla antes de borrar sus datos. La guía de problemas de rendimiento describe Help: Start Extension Bisect, que desactiva grupos de extensiones y pregunta si el problema sigue. Cuando identifiques la extensión, sigue su procedimiento documentado de restablecimiento o reconstrucción. No hay una operación común de caché que pueda restablecer con seguridad todos los datos arbitrarios de las extensiones.

Medir antes de mover

En Finder, pulsa Shift + Command + G e introduce ~/Library/Application Support/Code. Revisa cada carpeta en vez de considerar todo el total como espacio recuperable. En Terminal puedes medir sin modificar nada:

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

La primera línea separa las cachés de la raíz de User; la segunda muestra si el almacenamiento de espacios de trabajo o el global ocupa la mayor parte. No sumes el padre y sus subcarpetas. Un mensaje de ruta inexistente indica que esa ubicación no existe, mientras que un error de permisos significa que la medición está incompleta.

Estas rutas corresponden a la instalación estable estándar. Si usas --user-data-dir o --extensions-dir, revisa los directorios indicados. La referencia de la línea de comandos documenta ambas opciones. Un entorno de desarrollo remoto necesita su propia investigación, no des por hecho que sus datos están en esta carpeta local.

Limpiar solo lo que se puede regenerar

1. Guarda el trabajo, termina las tareas del terminal integrado y sal por completo de VS Code con Command + Q. Cerrar una ventana no equivale a salir de la app.
2. Haz una copia de User antes de experimentar con el estado y guarda aparte lo que una extensión no pueda regenerar. Conserva los proyectos y su propia configuración .vscode.
3. Abre Code en Finder y mueve a la Papelera solo la carpeta identificada Cache, Code Cache, GPUCache o CachedData. Empieza por la relacionada con el problema y comprueba el resultado sin borrar todas las vecinas.
4. Revisa CachedExtensionVSIXs por separado si las descargas ocupan el espacio. Son archivos de instalación, no extensiones instaladas. Guarda en otro lugar cualquier instalador sin conexión irreemplazable. El descargador de extensiones reutiliza los paquetes existentes o descarga los que faltan.
5. Puedes borrar sesiones antiguas de logs cuando ya no necesites las pruebas de diagnóstico. Las sesiones nuevas escribirán nuevos registros, pero el historial borrado no se regenera.

Abre el mismo proyecto y comprueba el fallo original antes de vaciar la Papelera. Las cachés pueden volver al usar los recursos y el primer inicio puede tardar más. Es una reconstrucción normal, no una prueba de que la limpieza haya fallado.

Tratar el almacenamiento de espacios de trabajo como estado

User/workspaceStorage contiene carpetas identificadas por ID de espacio de trabajo. La implementación de Microsoft escribe state.vscdb y workspace.json; las extensiones también pueden guardar archivos específicos allí. Una entrada grande puede contener estado local útil, incluidas conversaciones de extensiones, en lugar de ser solo un índice.

Lee el workspace.json de una entrada para identificar su carpeta o espacio de trabajo. Puede quedar después de mover o borrar un proyecto, pero una carpeta ausente también podría estar en una unidad sin montar. Confirma cuál es el caso, copia la entrada, sal de VS Code y solo entonces considera borrar esa entrada concreta. Los archivos del proyecto son independientes, pero reabrirlos no recupera automáticamente el estado perdido del espacio o las extensiones. Conserva las entradas remotas o desconocidas.

Mantén User/globalStorage. Restablecerlo puede borrar datos persistentes de las extensiones y obligarte a iniciar sesión de nuevo, según la extensión y la versión de VS Code. Conservar solo settings.json no protege todo ese estado.

Comprobar el espacio y seguir diagnosticando

Repite las mediciones después de abrir y usar el proyecto. Los archivos de la Papelera siguen ocupando disco hasta que los elimines, así que una carpeta Code más pequeña no significa más espacio libre de inmediato. Mantén la posibilidad de recuperación hasta comprobar ajustes, extensiones y el síntoma original.

Si el fallo continúa, prueba una instancia aislada con directorios nuevos y sin usar:

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

Esto crea datos de prueba sin restablecer tu configuración habitual. Si no encuentras code, sigue la configuración de macOS enlazada desde la referencia de comandos. No actives Settings Sync ni instales extensiones antes de la primera comparación. Una instancia limpia que funciona apunta a una diferencia en el perfil o las extensiones habituales, no necesariamente a una caché dañada. Si perdiste el inicio de sesión después de limpiar, deja de borrar, revisa qué carpetas de estado moviste y restaura la copia cuando corresponda, con VS Code cerrado.

Qué hace Mole

En Limpiar, Mole Mac muestra CachedData, Code Cache, GPUCache y las subcarpetas existentes WebStorage/<id>/CacheStorage, seleccionadas por defecto cuando están disponibles. Las entradas de Application Support requieren acceso total al disco y VS Code abierto bloquea las filas correspondientes hasta que salga. Las entradas huérfanas de User/workspaceStorage cuya carpeta local ya no existe son solo para revisión y empiezan sin seleccionar. No limpiar nunca este tipo excluye esa regla de VS Code, incluidas futuras coincidencias. Estas filas no apuntan a ajustes, almacenamiento global ni extensiones activas. Borrado de cachés usa por defecto Borrar permanentemente, también para estas entradas de espacios de trabajo, sin excepción que fuerce la Papelera. Para poder recuperar, elige Mover a la Papelera en Borrado de cachés. La guía de la app probada VS Code cubre la lista de desinstalación por separado.

Para quitar el editor consulta Desinstalar VS Code en Mac. Las cachés de gestores de paquetes y compilación de proyectos están en la guía de cachés de desarrollo.

Preguntas frecuentes

¿Se borrarán mis ajustes o extensiones?

Los pasos limitados a la caché conservan User y ~/.vscode/extensions. Borrar toda Code restablece los datos de usuario y es otra operación, como explica la documentación de desinstalación de Microsoft.

¿Por qué vuelve a crecer la caché?

VS Code regenera las cachés de código y gráficos al usarlo. Los archivos de extensiones que falten pueden descargarse durante instalaciones o actualizaciones posteriores. Borrarlos repetidamente no arregla una extensión que sigue generando demasiados datos.

¿Puedo borrar todo el almacenamiento de espacios de trabajo?

Descartarías el estado local de todos los espacios guardados. Revisa cada entrada y conserva copias. Que una carpeta se recree al iniciar no significa que se haya recuperado su contenido anterior.