VSCode本地缓存占用高主因是WorkspaceStorage、Cache、GPUCache和插件-cache目录长期堆积;需先彻底退出所有相关进程,再分层清理这些目录,不可直接删%APPDATA%\Code\User等配置目录。

VSCode本地缓存占用高,90%不是代码或项目的问题,而是Cache、WorkspaceStorage、GPUCache和插件残留这四类目录长期堆积导致的;直接删整个%APPDATA%\Code会丢配置,必须分层清理、先杀进程再动手。
怎么快速定位哪个缓存目录在吃空间?
别靠猜——进系统路径手动看大小最准。Windows 下打开 PowerShell,运行:
cd "$env:APPDATA\Code"
Get-ChildItem -Directory | ForEach-Object {
$size = (Get-ChildItem $_.FullName -Recurse -File | Measure-Object -Property Length -Sum).Sum
[PSCustomObject]@{Folder=$_.Name; SizeMB=[math]::Round($size/1MB, 2)}
} | Sort-Object SizeMB -Descending
重点关注这几项(按体积常见程度排序):
-
WorkspaceStorage:单个子目录常达 1–5 GB,是 C 盘最大头目,名字是哈希值,无法靠名识别,得按“修改日期”筛 -
Cache和GPUCache:纯运行时缓存,加起来常占 3–8 GB,可全删,重启自动重建 -
CachedData:插件与内核编译缓存,1–5 GB,极低风险,放心删 -
Extensions下带-cache后缀的文件夹(如ms-python.python-2024.12.0-cache):损坏更新残留,会导致语言服务起不来,只删这类,别碰主扩展目录
为什么删完缓存磁盘空间没变?
文件被进程锁住了。VSCode 不彻底退出,Windows/macOS/Linux 都不会真正释放空间。必须确认以下进程全部消失:
- Windows:
Code.exe、Code Helper.exe、node.exe(尤其后台静默运行的) - macOS:活动监视器里搜
Code和Electron,强制退出所有相关项 - Linux:
pkill -f "code"或killall code - 如果用过 Remote - WSL:先在 VSCode 里执行
Remote-WSL: Close Remote Connection,再终端运行wsl --shutdown
删完不重启 VSCode,空间也不会立即回收;重启后首次加载稍慢属正常,不影响 settings.json 或已打开文件。
WorkspaceStorage 怎么精准删又不拖慢下次启动?
这是最容易误操作也最该细抠的部分。它不是临时缓存,而是每个工作区的符号索引、搜索快照、调试上下文等持久化数据,VSCode 从不主动清理旧项。
路径:
- Windows:
%APPDATA%\Code\WorkspaceStorage - macOS:
~/Library/Application Support/Code/WorkspaceStorage - Linux:
~/.config/Code/WorkspaceStorage
操作要点:
- 进目录后,按“修改日期”排序(不是创建时间),删除所有修改时间早于 90 天的子目录
- 重点盯体积标着 “1.2 GB”、“2.7 GB” 的长名目录——大概率是已废弃的 WSL 工作区、monorepo 或含大量
node_modules的 Python 项目残留 - 删错不会影响
.vscode/settings.json,但首次重连该工作区会慢几秒重建索引
哪些目录绝对不能动?
以下路径删了等于重装 VSCode:
-
%APPDATA%\Code\User\:含settings.json、keybindings.json、代码片段、信任工作区标记 -
%APPDATA%\Code\GlobalStorage\:存登录态、扩展授权信息、GitHub Copilot 等状态 -
%USERPROFILE%\.vscode\extensions\主扩展目录(如ms-python.python-2024.12.0):删了插件就没了,得重装
真正该清的是它们的附属物:-cache 子目录、CachedData、Cache、GPUCache 和老旧的 WorkspaceStorage 子项——这些才是膨胀主力,且删后无副作用。











