优先使用内置更新，若help→check for updates灰色或卡住，则检查管理员运行、安装路径、包管理器及版本过旧等硬性条件；失败后手动下载覆盖安装最稳妥，配置全保留。
能直接点菜单更新的，优先用内置方式；但灰色、卡住、反复失败时，别硬等，手动下载覆盖安装最稳。
Help → Check for Updates 是灰色的？先查三个硬性条件
灰色不是 bug，是 VS Code 主动禁用了更新通道。常见原因有：
- Windows 上以管理员身份运行了
Code.exe（哪怕装的是 User 版本），系统策略会锁死更新入口 - macOS 下
Visual Studio Code.app没放在/Applications文件夹里，系统无法调用更新守护进程 - Linux 用
sudo apt install code或sudo snap install code安装的，内置菜单根本无效——它只管自己打包，不管系统包管理器 - 旧版本太老（比如 v1.50 以前），微软已停服该版本的更新 API，
curl -I https://update.code.visualstudio.com/api/update/...会返回403或超时
内置更新卡在“正在下载”超过 2 分钟？别干等
VS Code 内置更新直连微软 CDN，国内网络波动时容易卡死，且无重试、无 fallback、不报错。临时解法：
- 关掉所有 VS Code 进程（包括后台
Code Helper） - 删掉缓存目录：
~/.vscode/updates/（macOS/Linux）或%USERPROFILE%\AppData\Roaming\Code\Updates\（Windows） - 重启 VS Code，再试一次
Help → Check for Updates
如果仍失败，说明通道不可靠，跳到下一步。
手动下载覆盖安装：保留全部配置，最稳妥
官网下载的安装包默认就是覆盖安装，%USERPROFILE%\AppData\Roaming\Code（Windows）、~/Library/Application Support/Code（macOS）、~/.config/Code（Linux）里的设置、插件、SSH 配置全保留。
- Windows：去 code.visualstudio.com 下载
VSCodeUserSetup-x64-*.exe，双击安装，勾选“添加到 PATH”按需 - macOS：下载
.zip包，解压后把Visual Studio Code.app拖进/Applications覆盖原应用（注意：不要用 Homebrew 的visualstudiocodecask，它可能装错架构） - Linux（deb）：下载
code_*.deb，运行sudo apt install ./code_*.deb（别用dpkg -i，依赖易出错）
插件更新和 VS Code 本体更新是两回事
很多人混淆这点：Extensions: Auto Update 只控制插件自动升级，跟 VS Code 自身更新无关。插件更新走的是 npm registry，本体更新走的是微软更新服务。如果你发现插件没升，检查设置里的 extensions.autoUpdate；如果 VS Code 版本卡住，别翻插件设置，得看上面说的系统级条件。
真正容易被忽略的是：Linux Snap 版默认沙箱限制读取 $HOME/.gitconfig，Mac Homebrew 可能装错 arm64/x64 架构，Windows 管理员权限启动直接废掉更新入口——这些都不是“更新功能坏了”，而是环境没对齐。
