VSCode 更新失败通常因路径、权限或网络问题，而非软件故障；手动覆盖安装可保留全部配置，版本回退也安全可行。

VSCode 更新失败，**绝大多数情况不是软件本身坏了，而是更新机制被路径、权限或网络卡住了**。自动更新只是个“快捷方式”，它依赖特定条件才能触发；一旦出问题，手动更新最稳，版本回退也完全可行——而且不会丢配置、插件或工作区设置。

为什么自动更新总卡在“Failed to install Visual Studio Code update”

这个错误背后通常不是 VSCode 坏了，而是它的更新程序（vscode-inno-updater）找不到目标位置或没权限写入：

• 你把 VSCode 装在了非默认路径（比如 D:\Tools\VS Code），但更新器仍固执地去 %USERPROFILE%\AppData\Local\Programs\Microsoft VS Code 找 Code.exe —— 结果路径不存在，直接报错
• Windows 权限拦截：安装在 Program Files 或受控目录时，普通用户无法覆盖可执行文件，即使点了“立即更新”，也会静默失败
• 杀毒软件（如 360、火绒、Windows Defender 勒索防护）把 vscode-inno-updater.exe 当成可疑进程干掉了
• macOS 上的隔离属性（com.apple.quarantine）未清除，导致系统拒绝更新签名验证

手动更新：三步覆盖安装，零风险保留全部数据

VSCode 的用户数据（设置、插件、片段、快捷键）全存在独立目录，和安装目录物理分离。所以「下载新包覆盖安装」是最干净、最可控的方式：

• 访问官网下载页：https://www./link/30580a4caf21ef930b7774a2eff4aa26，选对系统和架构（注意 Apple Silicon 用户选 .zip 或 .dmg ARM64 版）
• Windows：运行新 VSCodeSetup-x64-*.exe，勾选 将 Code 添加到 PATH（保留命令行调用能力）；若原安装是便携版（无 installer），直接解压替换整个文件夹即可
• macOS：把新下载的 Visual Studio Code.app 拖进 /Applications，系统会提示替换——点“替换”，旧图标和 Launchpad 快捷方式自动更新
• Linux（deb/rpm）：

  sudo apt update && sudo apt install --only-upgrade code

  （Debian/Ubuntu）；Snap 用户用

  snap refresh code --channel=stable

完成后打开 VSCode，执行 Help → About 确认版本号；所有插件、设置、SSH 远程连接配置均完好无损。

版本回退：当新版引发兼容性问题（如远程开发断连、插件崩溃）

如果你刚升到 v1.92，发现 Remote-SSH 连不上服务器，或者 ESLint 报 Cannot find module 'vscode'，别硬扛——回退到上一个稳定版（如 v1.91.1）是合理选择：

• 前往微软官方历史版本存档页：https://www./link/1ec514b83b01ddf05e92f096fdf966a9（把 URL 中的 v1_91 替换成你需要的版本号）
• 找到对应平台的离线安装包（.exe/.dmg/.deb），下载后按前述“手动更新”流程覆盖安装
• 特别注意：macOS 用户若回退到不支持当前系统的新版（如 v1.91 要求 macOS 12+），请先确认兼容性；老系统（macOS 11 及更早）只能用 v1.90 或更早版本
• Windows 用户若遇到回退后插件失效，可临时删掉 %USERPROFILE%\.vscode\extensions 下缓存，重启后插件会自动重装

容易被忽略的关键细节

很多人试了重启、关杀软、清缓存还失败，往往栽在这几个地方：

• %AppData%\Code 和 %USERPROFILE%\.vscode 是两个不同目录：前者存设置和全局状态，后者存插件；误删后者会导致插件全丢
• macOS 上执行 xattr -dr com.apple.quarantine /Applications/Visual\ Studio\ Code.app 后，必须重启 Finder（或执行 killall Finder）才生效
• Linux Snap 安装的 VSCode，永远不要手动覆盖 /snap/code 下的文件——它会被 snapd 下次刷新时覆盖回去，应统一用 snap refresh
• 企业环境若禁用了 update.code.visualstudio.com，即使手动下载，插件市场也可能加载不出——这时需在 VSCode 设置里配好 HTTP 代理，或改用国内镜像源（如清华源）