【免费下载链接】vscode-docs
Public documentation for Visual Studio Code
导读
本文基于 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):
- 搜索并打开 Add or Remove Programs(添加或删除程序);
- 在 Apps > Apps & features(应用与功能)列表中找到 VS Code;
- 点击右侧操作菜单(三个竖点)中的 Uninstall(卸载);
- 按照提示完成卸载。
- 控制面板(Control Panel):
- 在 Programs(程序) 下选择 Uninstall a program(卸载程序) 链接;
- 找到 VS Code 条目,右键选择 Uninstall(卸载);
- 按照提示完成卸载。
需要说明的是,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 非常简单:
- 打开 Finder(访达),进入 Applications(应用程序);
- 右键点击 Visual Studio Code.app;
- 选择 Move to Trash(移到废纸篓)。
如果需要完全移除,还可以清空废纸篓。注意 macOS 上 VS Code 也支持便携模式(code-portable-data 目录位于应用旁),如果启用了便携模式,删除应用后数据目录依然保留,可参照 便携模式文档 处理。
Linux 平台卸载
在 Linux 上,卸载 VS Code 应使用当初安装时所用的包管理器的 remove/uninstall 命令。具体命令因包管理器而异(apt-get、dnf、yum、snap、zypper 等)。VS Code 的软件包名称统一为:
| 包名 | 说明 |
|---|---|
code | VS Code Stable(稳定版) |
code-insiders | VS 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 |
相关文档
- 安装与更新总览(Setup overview) —— VS Code 安装与更新的通用信息
- Windows 安装指南 —— Windows 上 User/System 安装器与 ZIP 安装细节及常见问题
- macOS 安装指南 —— macOS 安装、
code命令 PATH 配置与常见问题 - Linux 安装指南 —— Linux 各发行版的可用软件包与安装方式
- 便携模式(Portable mode) —— 数据目录随安装移动时的清理与迁移方法
- 设置同步(Settings Sync) —— 卸载/重置前的配置备份途径
- 命令行选项(Command-line options) ——
--user-data-dir、--extensions-dir等高级 CLI 参数 - 其他组件与工具(Additional components) —— 卸载后重建开发环境所需的基础组件(Git、Node.js、TypeScript 等)
【免费下载链接】vscode-docs
Public documentation for Visual Studio Code
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



