VSCode无官方“恢复模式”，但可通过code --disable-extensions --user-data-dir=/tmp/vscode-recovery命令构造等效环境：禁用所有扩展、使用空用户数据目录、跳过市场请求与版本校验，实现干净排查基线。
插件更新失败后，别急着重装 VSCode 或删扩展目录——90% 的情况只需切换到「恢复模式」操作就能解决，核心是绕过自动更新机制的校验和缓存干扰。
怎么进入 VSCode 插件恢复模式
VSCode 本身没有叫“恢复模式”的官方开关，但通过组合命令行参数 + 设置干预，能构造出等效环境：它禁用所有第三方扩展、跳过市场网络请求、绕过版本兼容性强制检查，只加载最小运行时。这是排查更新失败最干净的起点。
- Windows/Linux：终端执行
code --disable-extensions --user-data-dir=/tmp/vscode-recovery - macOS：同样命令，前提是已配置
code命令（没配就先在 VSCode 菜单选 Shell Command → Install 'code' command in PATH） - 关键点：
--user-data-dir指向一个全新空目录，避免旧设置/缓存污染；--disable-extensions不是“禁用已启用的”，而是彻底不加载任何扩展进程 - 此时打开 Extensions 视图，你会看到所有插件都显示为“已禁用”，且右上角无“更新”提示——这正是你要的“干净基线”
更新失败后手动安装 .vsix 的可靠路径
自动更新卡住（比如进度条停在 0%、弹窗说“请手动下载”但点开链接下的是 Microsoft.VisualStudio.Services.VSIXPackage 这种无法直接安装的文件），说明市场 CDN 或签名验证链断了。必须走本地 .vsix 安装流，但要注意三个易错环节：
- 不要从浏览器直接下载带
.VSIXPackage后缀的文件——那是微软内部封装格式，不是标准 .vsix；正确做法是去插件页面点「Download Extension」按钮，或在命令面板里对目标插件执行Extensions: Download Specific Version - 安装前务必先卸载旧版：
code --uninstall-extension publisher.name.extension，否则新包可能因元数据冲突被静默忽略 - 安装命令必须用绝对路径：
code --install-extension /home/user/ext.vsix（Linux/macOS）或code --install-extension "C:\path\to\ext.vsix"（Windows，路径含空格时加英文双引号） - 安装完成后不要立刻重启 VSCode——先在恢复模式窗口里执行
Developer: Restart Extension Host，确认扩展列表里状态变为“已启用”且无红色警告图标
为什么恢复模式下仍装不上？重点查这三处
即使进了恢复模式、用了绝对路径、也卸载了旧版，.vsix 还是报错或无响应，问题大概率不在网络或权限，而在扩展自身与当前 VSCode 版本的底层契约断裂：
- 看错误信息是否含
Requires version X.X.X but got Y.Y.Y：这是 manifest.json 里engines.vscode字段校验失败，不是警告，是硬拦截。此时只能降级 VSCode（去历史版本页下载 v1.91.1 这类 LTS 版），或等插件作者发新版 - 执行
code --install-extension xxx.vsix --force强制覆盖（VSCode 1.88+ 支持），但仅对 API 兼容性未中断的扩展有效；若日志出现Cannot find module 'vscode'或vscode.workspace.rootPath is deprecated，说明插件调用了已被移除的 API，--force无效 - 某些插件（如 Copilot、Rust Analyzer）依赖特定 Node.js 子进程或原生二进制模块，恢复模式下若
~/.vscode/extensions/里残留了旧版编译产物（比如node_modules/.bin下的可执行文件），会触发SIGSEGV崩溃——这时要手动删掉对应扩展文件夹再重试
真正麻烦的不是装不上，而是装上了却在重启后自动变禁用：这说明扩展激活阶段就抛出了未捕获异常，VSCode 主动把它隔离了。这时候光看 Extensions 视图没用，得盯紧 Developer: Open Extension Host Log 末尾那几行 Error，尤其是 Activating extension 'xxx' failed 后面跟着的堆栈——它不会告诉你 Python 解释器在哪，但会暴露 require() 失败的具体模块名。
