VSCode插件缓存不能靠隐藏解决,因其属运行时临时文件,files.exclude无效;须关闭VS Code后手动清理多处缓存路径,包括extensions/cache、__pycache__、CachedData及workspaceStorage等,切勿删除整个插件目录。

VSCode插件缓存文件为什么不能靠“隐藏”解决
直接在设置里勾选「隐藏已知文件类型」或改files.exclude对插件缓存无效——这些文件(如__pycache__、.cache、cached-data)是插件运行时写入的临时产物,不属于工作区源码范畴,VS Code 的文件资源管理器根本不会读取它们。试图用"files.exclude"去过滤,只会让项目里真正该隐藏的构建产物失效,而缓存照常膨胀、卡顿照常发生。
真正有效的缓存清理路径和范围
插件缓存分散在多个物理位置,必须按类型定位后手动删,不是“隐藏”而是“移除”。关键路径如下:
-
%USERPROFILE%\.vscode\extensions\ms-python.python-2026.1.1\cache\(Windows)或~/Library/Application Support/Code/Extensions/ms-python.python-*/cache/(macOS):Pylance 符号缓存,体积最大,可整删 -
~/.vscode/extensions/*/__pycache__/和~/.vscode/extensions/*/cached-data/:几乎所有语言类插件都会建,命名规律强,搜索__pycache__或cached-data即可批量定位 -
%APPDATA%\Code\Cache、%APPDATA%\Code\CachedData(Windows)或~/Library/Caches/com.microsoft.VSCode(macOS):VS Code 自身缓存,可全删,重启自动重建
注意:workspaceStorage 里的缓存也得清,路径如%APPDATA%\Code\User\workspaceStorage\,否则下次打开同一项目,插件仍会加载旧快照。
删之前务必关掉 VS Code 并杀干净进程
缓存文件被占用时无法删除,尤其 macOS/Linux 下残留 Code Helper 进程会锁住 cache 目录。实操步骤:
- Windows:任务管理器中结束所有
Code.exe和Code Helper进程 - macOS:活动监视器搜
Code,强制退出全部相关项 - Linux:执行
pkill -f "code"或killall code
不彻底退出就删,轻则提示“权限被拒绝”,重则删到一半中断,导致后续插件启动失败或报 ENOENT 错误。
别碰 extensions 目录本身,只动子目录
很多人误以为删整个 ms-python.python-2026.1.1 文件夹是“清理缓存”,其实这是在卸载插件——它包含核心逻辑代码,删了就得重装。正确做法是只进该文件夹内部,找名字含 cache、__pycache__、cached-data 的子目录删,保留 out/、node_modules/、package.json 等主干结构。不确定时,先 ls -la 看修改时间:缓存目录通常比主文件夹新几小时甚至几分钟,且大小异常突出。


















