彻底删除vscode插件目录需清空~/.vscode/extensions/(macos/linux)或%userprofile%.vscode\extensions\(windows),并同步清理settings.json、keybindings.json、snippets/、缓存及shell配置残留。

彻底删除 VSCode 插件目录(含被禁用但未卸载的)
VSCode 的插件不会因“卸载”操作而真正从磁盘清除,只是移出激活列表,残留文件仍占空间、可能干扰新版本行为。关键路径是 ~/.vscode/extensions/(macOS/Linux)或 %USERPROFILE%\.vscode\extensions\(Windows)。这里存放所有已安装(含历史禁用)的插件包,包括带哈希后缀的旧版本。
实操建议:
- 完全退出 VSCode(检查进程管理器确认无
Code Helper或Code.exe剩余进程) - 直接删除整个
extensions文件夹——别只删子目录,有些插件会写入同名但不同哈希的多版本共存 - 若需保留个别插件,务必核对文件夹名是否匹配插件 ID(如
esbenp.prettier-vscode-9.10.0),而非仅看前缀 - Windows 用户注意:该路径可能被系统隐藏,需在文件资源管理器地址栏直接粘贴完整路径并回车
清除用户配置与全局设置(settings.json / keybindings.json)
settings.json 里混杂着手动编辑的配置、插件自动注入的设置、甚至已卸载插件遗留的字段(比如 "prettier.semi": false 在 Prettier 卸载后仍存在,可能引发未知覆盖)。这些不会随插件删除而消失,且 VSCode 启动时仍会解析它们。
实操建议:
- 定位用户配置目录:
~/.vscode/settings.json(macOS/Linux)或%APPDATA%\Code\User\settings.json(Windows) - 不要仅清空内容,先备份原文件(重命名为
settings.json.bak),再新建空白settings.json并写入{} - 同样处理
keybindings.json和snippets/目录——尤其后者常被忽略,但旧插件生成的代码片段会持续生效 - 如果用了 Settings Sync,同步前务必先关闭(
workbench.settings.enableSync设为false),否则重置后立刻被云端旧配置覆盖
清理缓存与临时数据(避免启动异常或扩展加载失败)
VSCode 运行时生成的缓存(如 Cache、CachedData、GPUCache)若损坏,会导致插件白屏、语言服务器卡死、甚至主界面渲染异常。这些目录不随卸载操作清理,且 Windows/macOS 权限问题常让它们残留顽固文件锁。
实操建议:
- 关闭 VSCode 后,删除以下路径(根据系统选择):
— macOS:~/Library/Caches/com.microsoft.VSCode*、~/Library/Application Support/Code/Cache
— Windows:%LOCALAPPDATA%\Programs\Microsoft VS Code\Cache、%APPDATA%\Code\Cache
— Linux:~/.config/Code/Cache、~/.cache/Code/ - 特别注意
CachedData目录(位于~/.vscode/CachedData/或%APPDATA%\Code\CachedData\):它存储扩展预编译产物,残留旧版会导致新插件加载报错ERR_UNKNOWN_FILE_EXTENSION - 不建议用第三方“清理工具”扫 VSCode 目录——它们常误删
argv.json或machineid,导致登录状态丢失或遥测 ID 重置
重装前验证是否还有隐藏残留(尤其是 Linux/macOS 的 shell 配置)
VSCode 安装时可能向 shell 配置文件(如 ~/.zshrc、~/.bash_profile)写入 code 命令别名或 PATH 条目。若残留旧路径(例如指向已删的 /Applications/Visual Studio Code.app/Contents/Resources/app/bin/code),终端执行 code --version 会报错或返回空,但用户不易察觉。
实操建议:
- 运行
which code或type -a code,确认命令来源;若输出路径已不存在,就需手动清理对应 shell 配置中的相关行 - 检查
~/.vscode/argv.json:它记录上次启动参数,若含已删除插件的调试配置,可能触发错误日志刷屏 - macOS 用户额外检查
~/Library/Preferences/com.microsoft.VSCode.helper.plist和~/Library/Saved Application State/com.microsoft.VSCode.savedState/,这两个目录存有窗口布局和恢复状态,旧版崩溃后可能卡住新实例
最麻烦的不是删不干净,而是删了部分却留了依赖链——比如清了插件但没清 settings.json 里的关联配置,重装同名插件后反而因配置冲突无法启用。动手前,先关进程、再备配置、最后按路径逐层删,比任何一键脚本都可靠。











