vs code 卸载插件仅移除注册表条目,不删除文件、配置及状态数据;必须手动清除 extensions 目录下插件文件夹、settings.json/keybindings.json 中相关配置、globalstorage 等状态目录,以及项目级 .vscode 文件夹。

VS Code 卸载插件 ≠ 删除插件文件,不手动清目录,下次启动照样加载失败或报错。
code --uninstall-extension 命令只删注册表,不碰文件
运行 code --uninstall-extension ms-python.python 或在 UI 点击「Uninstall」后,VS Code 仅从扩展清单(extensions.json)和缓存 manifest 中移除条目。插件实际文件仍完整保留在磁盘上:
-
%USERPROFILE%\.vscode\extensions\ms-python.python-2026.1.1\(Windows) -
~/Library/Application Support/Code/Extensions/ms-python.python-2026.1.1/(macOS) -
~/.vscode/extensions/ms-python.python-2026.1.1/(Linux)
这些残留文件夹会导致 Extension Host 加载 out/extension.js 失败,控制台持续报 Cannot find module 'vscode' 或类似路径错误。必须进对应路径,按 Extension ID(如 ms-python.python)精准定位并删除整个子文件夹。
settings.json 和 keybindings.json 里藏着“复活开关”
很多插件(比如 esbenp.prettier-vscode、github.copilot)会在用户配置中写入启用项或快捷键绑定。即使插件文件已删,这些残留配置仍会:
- 干扰新装同名插件的初始化(例如 Copilot 不弹登录框)
- 导致快捷键冲突(如
Ctrl+Enter被劫持但无响应) - 触发
editor.codeActionsOnSave等嵌套字段报错
打开命令面板(Ctrl+Shift+P),运行 Preferences: Open Settings (JSON),全局搜索插件 ID(如 copilot、prettier、anthropic.claude-code),逐行删掉相关字段;同样检查 keybindings.json(运行 Preferences: Open Keyboard Shortcuts (JSON))。
globalStorage 和 Cache 是插件“幽灵状态”的源头
VS Code 把插件私有数据(API 密钥、对话历史、上次激活状态)存在 globalStorage,语言服务器快照存在 CachedData 和 WorkspaceStorage。这些目录不随卸载清除,重装后常见现象包括:
- 插件卡在「正在激活…」动画不动
- 反复崩溃并重试激活(日志显示
Failed to activate extension) - Copilot / Claude 插件提示「已登录」但无法调用模型
清理路径(操作前确保所有 Code.exe / Code Helper 进程已退出):
- Windows:
%APPDATA%\Code\User\globalStorage、%APPDATA%\Code\Cache、%APPDATA%\Code\CachedData、%APPDATA%\Code\User\workspaceStorage - macOS:
~/Library/Application Support/Code/User/globalStorage、~/Library/Caches/com.microsoft.VSCode、~/Library/Application Support/Code/WorkspaceStorage - Linux:
~/.config/Code/User/globalStorage、~/.cache/Code、~/.config/Code/WorkspaceStorage
别漏掉项目级 .vscode 文件夹里的插件配置
有些插件(尤其是 Linter 或 Formatter 类,如 editorconfig.editorconfig、redhat.vscode-yaml)会在项目根目录的 .vscode/settings.json 中写入启用开关或格式化规则。即使全局卸载了插件,该文件仍可能保留 "editor.formatOnSave": true + "editor.defaultFormatter" 组合,导致保存时静默失败或抛出 Extension 'xxx' is not installed 错误。
进入你常开发的项目目录,检查是否存在 .vscode/ 文件夹;若存在,确认其中 settings.json、extensions.json 是否含已卸载插件的引用,直接删或注释掉对应行即可。
真正干净的重装,不是看插件列表空了,而是扩展目录空、配置 JSON 干净、globalStorage 归零、项目级设置无残留——四者缺一不可。尤其 globalStorage,最容易被跳过,但它恰恰是 Copilot、Claude、GitHub Codespaces 等现代 AI 插件反复失活的根源。











