必须手动删除Cache、CachedData、extensions、globalStorage、workspaceStorage及settings.json中残留配置,否则插件会卡在“正在激活”、图标不显示或复用旧API Key;各目录作用不同且缺一不可,删前须彻底退出VSCode进程。

VSCode插件本地缓存不会随「卸载」自动清除,必须手动删 Cache、CachedData、extensions 目录里的对应文件夹,否则会卡在“正在激活”、图标不显示、甚至复用旧 API Key。
Cache 和 CachedData 必须一起清,只清一个会卡加载
这两个目录不是可选项,是插件市场和语言服务器的底层依赖:
-
Cache存的是 HTTP 响应体(比如gallery.visualstudio.com的 JSON、CDN 图标),删它会让 Extensions 视图首次打开变慢,但能强制拉新数据 -
CachedData存的是扩展元数据快照(含版本号、分类、截图 URL),删它才能让插件列表真正刷新,否则搜“prettier”可能还显示 2024 年的老版本 - Windows 路径:
%APPDATA%\Code\Cache和%APPDATA%\Code\CachedData - macOS 路径:
~/Library/Caches/com.microsoft.VSCode和~/Library/Application Support/Code/CachedData - Linux 路径:
~/.cache/Code和~/.config/Code/CachedData - 删之前务必退出所有 VSCode 进程(
killall -9 Code或任务管理器杀光Code.exe和Code Helper)
extensions 目录下不能只靠 UI 卸载,得进磁盘删文件夹
点「Uninstall」只是把插件状态设为禁用,并更新 extensions\extensions.json 清单,.vscode\extensions 下的文件夹原封不动:
- Windows:
%USERPROFILE%\.vscode\extensions(注意是%USERPROFILE%,不是%APPDATA%) - macOS/Linux:
~/.vscode/extensions(~/Library/Application Support/Code/Extensions是另一套,也得清) - 别猜文件夹名——右键插件 →
Copy Extension ID(如esbenp.prettier-vscode),再在文件管理器里全局搜索精准匹配 - 优先删带
-cache后缀的(如ms-python.python-2026.8.0-cache),这是更新中断残留的半成品,VSCode 会优先加载它并静默失败 - 体积超 500 MB、修改时间半年前的长名文件夹(如
ms-python.python-2024.1.0),大概率是废弃旧版,可删
globalStorage 和 workspaceStorage 是最易漏的敏感残留
这些目录里藏的是插件运行时写入的私有数据,比如 TaoToken 的 API Key、对话历史、模型额度缓存,卸载后不删就等于把密钥留在磁盘上:
-
globalStorage路径:Windows 是%APPDATA%\Code\User\globalStorage\,macOS 是. ~/Library/Application Support/Code/User/globalStorage/. -
workspaceStorage路径:Windows 是%APPDATA%\Code\User\workspaceStorage,macOS 是~/Library/Application Support/Code/WorkspaceStorage - 很多插件(如 Python、Rust)在此缓存项目级语言服务器状态,残留会导致「扩展主机意外终止」
- 如果你用 TaoToken 类统一通道,
globalStorage下的 Key 缓存不清理,重装插件后第一次请求就会带着旧 Key 发出去 - 删
workspaceStorage不影响全局设置,但会清掉当前工作区的语言服务缓存,重启后需重新索引
settings.json 里残留配置会干扰新装插件
插件卸载后,settings.json 里那些 "prettier.requireConfig": true 或 "python.defaultInterpreter" 还在,新装同名插件会直接继承,导致冲突或崩溃:
- 打开命令面板(
Ctrl+Shift+P),运行Preferences: Open Settings (JSON) - 搜索插件 ID(如
prettier.、python.、drawio.),整行删除,注意保留 JSON 语法正确性(逗号、缩进) - 有些设置嵌在对象里(如
"editor.codeActionsOnSave"下的子字段),光搜关键词可能漏,得看上下文结构 - 不确定某项是否属于已删插件?先加
//注释掉,重启 VSCode 测试功能是否正常,再决定删还是留
真正干净的标志不是插件列表为空,而是打开 Developer: Show Running Extensions 后没一行输出,且 code --status 显示的 user data dir 下 extensions 目录为空——任何“自动复现旧状态”的迹象,都说明某个路径漏删了,尤其是 globalStorage 和 workspaceStorage 这类非直观位置。











