如何彻底清除VS Code插件及其残留文件？

本文共计924个文字，预计阅读时间需要4分钟。

禁用插件不低于卸载操作。VS Code 的卸载按钮仅删除注册表条目和扩展清单，插件文件夹、设置项和缓存全部保留——下次启动仍可能触发生命逻辑或错误。

插件物理文件夹在哪？直接删才真正卸载

VS Code 不会自动清理已卸载插件的磁盘文件。插件本体是解压后的完整文件夹，必须手动定位并删除：

• Windows：%USERPROFILE%\.vscode\extensions（如 ms-python.python-2026.1.1）
• macOS：~/Library/Application Support/Code/Extensions/
• Linux：~/.vscode/extensions/

别靠名字猜——右键插件 → 「Copy Extension ID」（如 ms-python.python），再在文件夹里按此 ID 搜索，精准匹配后整文件夹删掉。删错父目录 extensions 会导致所有插件丢失，但删单个子文件夹是安全的。

settings.json 里藏着插件配置，不清理会干扰新装同名插件

很多插件（比如 esbenp.prettier-vscode 或 hediet.vscode-drawio）会在全局 settings.json 里写入配置项，即使插件已删，这些键值仍存在，重装时会被自动继承，甚至引发冲突。

• 打开命令面板（Ctrl+Shift+P），运行 Preferences: Open Settings (JSON)
• 搜索插件 ID 或常见关键字（如 prettier.、drawio.、python.defaultInterpreter）
• 整行删除，保存后重启 VS Code

注意：有些设置项嵌套在对象里（如 "editor.codeActionsOnSave" 下的子字段），光搜关键词可能漏掉，得看上下文。

插件缓存和运行时数据藏在非 extensions 目录里

插件卸载后，Cache、CachedData、workspaceStorage 这些目录仍保留其二进制缓存、语言服务器快照、临时状态——它们不占大空间，但可能让新装插件卡在「正在激活」或反复崩溃。

• Windows：%APPDATA%\Code\Cache、%APPDATA%\Code\CachedData、%APPDATA%\Code\User\workspaceStorage
• macOS：~/Library/Caches/com.microsoft.VSCode、~/Library/Application Support/Code/WorkspaceStorage
• Linux：~/.cache/Code、~/.config/Code/WorkspaceStorage

清空这些目录前，确保 VS Code 已完全退出（任务管理器里没有 Code.exe 或 Code Helper 进程），否则部分文件被占用删不掉。

为什么 code --uninstall-extension 有时没用？

这个命令本质是调用 UI 卸载流程，只对「当前启用/已安装状态」的插件生效。如果插件早已被禁用、或你手动删过文件夹但没清注册表，它会报 Extension 'xxx' is not installed.，但其实残留还在磁盘上。

• 先用 code --list-extensions 确认插件是否还在列表里
• 若不在，说明 UI 层已“卸载”，但物理文件和配置很可能还活着
• 此时唯一可靠方式就是直奔 extensions 目录删文件夹 + 清 settings.json + 清缓存路径

真正难清理的不是插件本身，而是它悄悄写进用户数据目录的配置项、缓存、甚至全局 snippets ——这些不会出现在插件市场页面里，也从不提示你「我留下了什么」。