VSCode插件崩溃需三步彻底重置:1.热重启扩展宿主(Ctrl/Cmd+Shift+P→Developer: Restart Extension Host);2.关闭所有进程后删除.vscode/extensions文件夹;3.重命名User目录并关闭Settings Sync,再清理globalStorage等残留。

VSCode 没有一键重置插件崩溃故障的按钮,所谓“一键”,本质是组合三步:停掉扩展宿主进程 + 清插件本体 + 清用户级残留数据。只做其中一步,90% 会复发。
执行 Developer: Restart Extension Host 热重启
这是第一响应动作,不是“重置”,但能立刻恢复语法高亮、补全、格式化等功能,且不丢失当前编辑会话、终端、调试状态。
- 快捷键:
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入并回车Developer: Restart Extension Host - 若执行后立刻再次弹出
Extension host terminated unexpectedly,说明有插件在激活阶段就失败(比如ms-python.python找不到解释器),此时热重启只是掩耳盗铃 - 某些插件(如
bradlc.vscode-tailwindcss)重启后需重新扫描大量文件,短暂卡顿 ≠ 失败,别急着关掉
删干净 .vscode/extensions 文件夹
UI 界面里点“Uninstall”只是把插件从启用列表里划掉,ms-python.python-2026.1.1 这类文件夹仍躺在磁盘上,下次启动可能被自动加载,甚至触发旧缓存逻辑。
- 必须先彻底关闭所有 VSCode 进程(Windows 查任务管理器,macOS 查活动监视器,确认无
Code Helper) - 然后删除对应路径下的整个
extensions文件夹:
— Windows:%USERPROFILE%\.vscode\extensions
— macOS:~/.vscode/extensions
— Linux:~/.vscode/extensions - 注意:
.vscode/extensions是插件代码本体所在;而%APPDATA%\Code\User\extensions.json只是启用清单——删后者不等于卸载
清空 User 目录并关掉 Settings Sync
只删插件不碰 User 目录,大概率遇到“插件没了,但编辑器还是卡、高亮错乱、终端打不开”。因为 keybindings.json 里绑了已卸载插件的快捷键,settings.json 里还留着 "python.defaultInterpreterPath" 这种字段,globalStorage 下的插件私有缓存也还在。
- 找到对应平台的
User目录:
— Windows:%APPDATA%\Code\User
— macOS:~/Library/Application Support/Code/User
— Linux:~/.config/Code/User - 不要直接删,重命名为
User_backup(万一某段 snippet 或登录态真有用,还能翻出来) - 务必提前关闭 Settings Sync(左下角齿轮 → Settings Sync → Turn Off),否则重启后几秒内就会从 GitHub/GitLab 账户拉回旧配置,白忙一场
真正麻烦的从来不是插件本身,而是它写进 globalStorage 的缓存、改过的 keybindings.json、以及和 %LOCALAPPDATA%\Code 里语言服务器快照的耦合。这些不会随插件删除自动清理,得手动动刀。











