vscode无法自动更新通常因网络限制、权限问题、安装方式特殊或更新服务被禁用;手动更新简单且不丢失设置和插件,需根据安装来源选择对应方法(如snap refresh、apt upgrade或官网下载覆盖安装)。

VSCode 无法自动更新,通常是因为网络限制、权限问题、安装方式特殊(比如通过 Snap 或系统包管理器安装),或后台更新服务被禁用。官方推荐的自动更新机制在某些环境下会失效,但手动更新其实很简单,也不影响你的设置和插件。
检查 VSCode 安装来源
不同安装方式决定你能否/如何更新:
- windows/macOS 官网下载的 .exe 或 .zip 版:支持自动更新,也支持直接下载新版本覆盖安装
- linux 上通过 Snap 安装(如 ubuntu 默认):自动更新由 snapd 管理,需运行 snap refresh code,不能手动替换二进制文件
- Linux 上通过 apt/yum/dnf 安装:更新依赖系统包管理器,例如 sudo apt update && sudo apt upgrade code
- 便携版(Portable)或解压即用版:不带自动更新,需手动下载新版压缩包并替换整个文件夹(配置默认保留在用户目录,不受影响)
手动下载安装最新版(通用方法)
适用于所有平台,尤其适合自动更新失败时快速解决:
- 打开官网下载页:https://code.visualstudio.com/Download
- 选择对应系统和架构(注意:windows 用户区分 64 位 / ARM64;macOS 注意 apple Silicon 还是 Intel)
- 下载完成后:
修复自动更新失效(Windows/macOS)
若想恢复自动更新,可尝试以下操作:
- 确保没有禁用更新:打开 VSCode → 设置(Ctrl+,)→ 搜索 “update mode” → 确认 “Update: Mode” 设为 “default”
- 检查代理或防火墙:VSCode 更新走 HTTPS,如果公司网络或系统级代理拦截了 update.code.visualstudio.com,会导致静默失败
- 重启更新服务(Windows):任务管理器中结束所有 Code Helper 和 Code Setup 进程,再重启 VSCode
- 重置更新缓存(macOS/Linux):删除 ~/.vscode-oss/updates 或 ~/Library/Caches/com.microsoft.VSCode.ShipIt(macOS)后重启
更新后插件与设置是否保留?
是的,完全保留。VSCode 的用户数据(包括插件、设置、快捷键、代码片段、Snippets)都存在独立的用户目录中:
- Windows:%APPDATA%Code
- macOS:~/Library/Application Support/Code
- Linux:~/.config/Code
只要不是卸载重装,而是覆盖安装或升级安装,这些目录不会被触碰,无需额外备份或迁移。