vscode工作区缓存主要位于.vscode/.workspacestorage和~/.vscode/extensions中与工作区关联的扩展子目录;前者存储扩展状态、调试历史等专属数据,后者含语言服务等独立缓存,删除二者可彻底清空工作区缓存。

VSCode 工作区缓存存在哪几个位置
VSCode 的“工作区缓存”不是单一文件,而是分散在多个路径下的临时数据:用户级设置缓存、扩展缓存、搜索索引(search.cache)、文件监视快照(.vscode/.history 或 .vscode/.workspaceStorage)、以及调试器/语言服务器的本地状态。真正影响重开工作区行为的,主要是 .vscode/.workspaceStorage 和 ~/.vscode/extensions 中与该工作区关联的扩展缓存。
删掉 .vscode/.workspaceStorage 是最直接有效的操作
这个目录保存了当前工作区专属的扩展状态、调试会话历史、终端环境变量快照、自定义视图布局等——它不会被 Reload Window 清除,也不会随 Close Folder 自动清理。手动删除后,VSCode 下次打开该工作区会重建干净的存储空间。
- 路径示例(macOS/Linux):
~/your-project/.vscode/.workspaceStorage - 路径示例(Windows):
C:\path\to\your-project\.vscode\.workspaceStorage - 注意:
.workspaceStorage是隐藏目录,确保显示隐藏文件才能看到 - 别误删
.vscode/settings.json或.vscode/tasks.json,它们是用户配置,不属于缓存
配合清理 ~/.vscode/extensions 中相关扩展缓存
某些扩展(比如 ms-python.python、esbenp.prettier-vscode)会在全局扩展目录下为每个工作区生成独立缓存子目录,名字含工作区路径哈希。这些缓存不随工作区删除而消失,可能造成语言服务响应异常或格式化规则不生效。
- 先关闭 VSCode
- 进入
~/.vscode/extensions(macOS/Linux)或%USERPROFILE%\.vscode\extensions(Windows) - 查找含项目名或路径片段的子目录(如
ms-python.python-2024.10.1_9a7b3c...里有workspaceState或cache文件夹) - 可安全删除整个扩展子目录(重启后会自动重装并重建)
别碰 ~/.vscode/User 和 ~/.vscode/storage.json
这两个属于用户级配置和全局状态,清空会导致所有工作区的快捷键、主题、窗口布局、最近打开记录全丢,且无法按工作区分隔恢复。除非你明确想重置整个 VSCode 用户环境,否则不要动它们。
真正要“彻底清空工作区缓存”,核心就是两步:关 VSCode → 删 .vscode/.workspaceStorage → (可选)扫一遍 ~/.vscode/extensions 里带工作区特征的缓存子目录。其他所谓“清理插件”或“重置工作区命令”基本都绕不开这两处物理路径。











