Visual Studio Code 卸载与彻底清理指南:Windows / macOS / Linux 全平台实战

  • 文档
  • 教程

【免费下载链接】vscode-docs

Public documentation for Visual Studio Code

项目地址: https://gitcode.com/gh_mirrors/vs/vscode-docs
点击查看 免费下载

导读

本文基于 vscode-docs 仓库中的 卸载指南,系统讲解 Visual Studio Code(VS Code)在 Windows、macOS、Linux 三个平台上的卸载方法、不同安装方式(Windows Installer、ZIP、.deb、.rpm、Snap 等)对应的正确移除流程,以及卸载后如何彻底清理用户数据(Code、.vscode-shared、.vscode 目录),让系统恢复到安装前的状态。读完本文,你将能够根据自己的平台和安装方式选择正确的卸载命令与 GUI 操作路径,并安全地重置或迁移 VS Code 的全部个性化配置。

卸载前须知:卸载方式取决于安装方式

VS Code 的卸载步骤取决于两个因素:操作系统平台(Windows、macOS 或 Linux)和当初使用的安装方式。例如在 Windows 上,你可以选择 System(系统级)或 User(用户级)Windows Installer,也可以下载 .zip 压缩包并解压到本机任意位置——这三者的卸载方式完全不同。

总体原则是:像卸载其他桌面应用一样,遵循所在平台推荐的软件卸载流程。下文给出各平台的详细指引,并补充如何彻底清理残留的 VS Code 配置文件。

提示:如果你只是想把设置重置回出厂状态、并不想真正卸载 VS Code,也可以直接删除用户数据目录,效果等价于"清空所有配置"。详细见下文彻底清理(Clean uninstall)一节。

Windows 平台卸载

Windows 上存在两种主流安装途径:Windows Installer(含 User 与 System 两个版本)和 .zip 解压版。请根据你的安装方式选择对应操作。

通过 Windows Installer 安装的卸载

如果你通过 Windows Installer(无论是 User 版本还是 System 版本)安装的 VS Code,请使用系统自带的卸载入口将其移除。两种 GUI 方式任选其一:

  • 开始菜单(Start menu):
    1. 搜索并打开 Add or Remove Programs(添加或删除程序);
    2. 在 Apps > Apps & features(应用与功能)列表中找到 VS Code;
    3. 点击右侧操作菜单(三个竖点)中的 Uninstall(卸载);
    4. 按照提示完成卸载。
  • 控制面板(Control Panel):
    1. 在 Programs(程序) 下选择 Uninstall a program(卸载程序) 链接;
    2. 找到 VS Code 条目,右键选择 Uninstall(卸载);
    3. 按照提示完成卸载。

需要说明的是,Windows 安装器的 User 与 System 两种形态安装位置不同(详见 Windows 安装指南):User setup 安装于 %LOCALAPPDATA%\Programs\Microsoft VS Code,无需管理员权限;System setup 安装于 Program Files,需要管理员权限,卸载时同样需要相应权限。

通过 .zip 文件安装的卸载

如果你是在 Windows 上下载并解压了官方 .zip 包(见 VS Code 官网下载页的 Alternative downloads)来安装 VS Code,那么卸载方式就是直接删除解压目录——删除 VSCode-win32-x64-{版本号} 文件夹即可。ZIP 版不注册到系统的安装清单中,因此不会出现在"应用与功能"列表里,也没有自动更新能力,只能手动删除并自行管理版本(这一点与 Windows 安装指南 中 ZIP 安装说明一致)。

注意:若你使用的是 便携模式(Portable mode),安装目录内还会有一个 data 文件夹,承载全部用户数据(会话状态、偏好设置、扩展等)。删除整个解压目录即可一并清除;若只想保留数据以备后续版本使用,可先将 data 文件夹复制到新版解压目录中。

macOS 平台卸载

在 macOS 上卸载 VS Code 非常简单:

  1. 打开 Finder(访达),进入 Applications(应用程序);
  2. 右键点击 Visual Studio Code.app;
  3. 选择 Move to Trash(移到废纸篓)。

如果需要完全移除,还可以清空废纸篓。注意 macOS 上 VS Code 也支持便携模式(code-portable-data 目录位于应用旁),如果启用了便携模式,删除应用后数据目录依然保留,可参照 便携模式文档 处理。

Linux 平台卸载

在 Linux 上,卸载 VS Code 应使用当初安装时所用的包管理器的 remove/uninstall 命令。具体命令因包管理器而异(apt-get、dnf、yum、snap、zypper 等)。VS Code 的软件包名称统一为:

包名说明
codeVS Code Stable(稳定版)
code-insidersVS Code Insiders(预发布版,与稳定版并排安装、配置互相隔离)

Debian / Ubuntu(.deb + apt)

如果你通过 Debian 软件包(.deb)安装的 VS Code,使用 apt-get 卸载:

sudo apt-get remove code

其中 code 即 VS Code Debian 软件包的名称(若安装的是 Insiders 版本,则为 code-insiders)。安装时若配置了官方 apt 仓库(详见 Linux 安装指南),卸载时也可用 sudo apt remove code。

RHEL / Fedora / CentOS(.rpm + dnf/yum)

通过 RPM 包或 yum 仓库安装的 VS Code,使用 dnf(Fedora 22 及以后)或 yum(更早版本)卸载:

# Fedora 22 及以后
sudo dnf remove code

# 更早版本
sudo yum remove code

Snap 包

通过 Snap 安装的 VS Code(sudo snap install --classic code),卸载命令为:

sudo snap remove code

openSUSE / SLE(zypper)

openSUSE 与 SLE 系统复用 yum 仓库,卸载使用:

sudo zypper remove code

Arch Linux(AUR)与 Nix

  • Arch 用户仓库(AUR)安装的 visual-studio-code-bin,请通过 AUR 辅助工具(如 yay/paru)的 -R 参数移除;
  • Nix 安装的 vscode 包,可用 nix-env -e vscode 移除。

卸载完成后,若包管理器仍认为系统中有残留的配置文件,通常不会影响日常使用;如需彻底清除,请继续执行下文彻底清理步骤。

彻底清理(Clean uninstall):删除用户数据目录

如果希望卸载 VS Code 后移除全部用户数据,可以删除 Code、.vscode-shared 和 .vscode 三个目录。这样系统将恢复到安装 VS Code 之前的状态。该方法同样适用于不想卸载、只想重置所有设置的场景——删除这些目录即相当于恢复出厂设置。

三个目录在不同平台上的位置如下:

平台用户数据目录共享数据目录扩展/杂项数据目录
Windows%APPDATA%\Code%USERPROFILE%\.vscode-shared%USERPROFILE%\.vscode
macOS$HOME/Library/Application Support/Code~/.vscode-shared~/.vscode
Linux$HOME/.config/Code~/.vscode-shared~/.vscode

各目录承载的内容(依据 便携模式文档 与相关安装文档可确认的部分):

  • Code(用户数据目录):保存编辑器设置(settings.json)、键盘快捷键、代码片段、工作区状态与 UI 状态等个性化数据。在便携模式迁移章节中,它被统称为 user-data;
  • .vscode:包含扩展安装目录 ~/.vscode/extensions 等数据,删除后所有扩展及其配置将一并清除;
  • .vscode-shared:跨安装共享的数据目录,删除后同样不再保留相关共享状态。

提醒:删除上述目录是不可逆操作。若你之前开启了 Settings Sync(设置同步) 且不希望丢失云端同步的配置,请先确认同步状态,或在卸载后重新登录账号恢复配置。

另外要注意:ZIP/便携版(Portable mode)安装的用户数据并不位于上述系统目录,而是全部集中在安装目录下的 data 文件夹中;data 文件夹会覆盖 --user-data-dir 与 --extensions-dir 两个命令行选项。因此清理便携版时直接删除 data 目录即可,无需处理 Code/.vscode 系统目录。

卸载后:回退版本与关闭自动更新

卸载并清理用户数据后,若想回退到某个旧版本,可以下载指定 版本发布说明 页面顶部提供的旧版安装包重新安装(该流程在 常见问题 FAQ 中有明确说明)。

另外,macOS 与 Windows 默认启用自动更新。如果你更希望自行掌控更新节奏,可以在设置中把 update.mode 从 default 改为 none(File > Preferences > Settings 中搜索 update mode,或直接编辑 settings.json):

{
    "update.mode": "none"
}

Linux 上若正确配置了官方软件仓库,自动更新由系统包管理器统一接管,与系统其他软件包一致(详见 Linux 安装指南)。

常见场景速查

场景操作
Windows(安装器版)卸载开始菜单 / 控制面板 → 卸载 VS Code
Windows(ZIP 版)卸载删除解压目录(含便携模式的 data 文件夹)
macOS 卸载Finder → Applications → 右键 VS Code → Move to Trash
Debian/Ubuntu 卸载sudo apt-get remove code(Insiders 为 code-insiders)
RHEL/Fedora/CentOS 卸载sudo dnf remove code 或 sudo yum remove code
Snap 卸载sudo snap remove code
openSUSE/SLE 卸载sudo zypper remove code
仅重置设置、不卸载删除 Code(Windows %APPDATA%\Code;macOS ~/Library/Application Support/Code;Linux ~/.config/Code)及 ~/.vscode、~/.vscode-shared
关闭自动更新设置 update.mode 为 none

相关文档

  • 文档
  • 教程

【免费下载链接】vscode-docs

Public documentation for Visual Studio Code

项目地址: https://gitcode.com/gh_mirrors/vs/vscode-docs
点击查看 免费下载

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值