在 Mac 上卸载 VS Code

移除 VS Code 和重置它的数据是两个决定。设置、快捷键和配置文件在一个文件夹里，扩展在另一个文件夹里，把应用移到废纸篓时两者都不会消失。以后可能重装的话，先备份。这份指南覆盖从 Microsoft 下载的 VS Code 和 Homebrew cask visual-studio-code，项目和项目自己的 .vscode 文件夹都不动。

先备份设置，再移除应用

在 VS Code 中保存文件，结束集成终端里的任务，再退出应用。用户设置通常在 ~/Library/Application Support/Code/User/settings.json，备份整个 ~/Library/Application Support/Code/User 可以一并保留快捷键、片段和配置文件。扩展在 ~/.vscode/extensions。在 Finder 按 Shift + Command + G 可以逐个打开这些位置，复制到备份目录后再移除应用。项目文件夹及项目自己的 .vscode 配置继续保留。

移除应用

Microsoft 给 macOS 的步骤是：打开 Finder，进入「应用程序」，右键点 Visual Studio Code，选择「移到废纸篓」。官方卸载说明

用 Homebrew 安装时

Mole 会先检查 zap 清单，涉及未勾选的数据、其他应用共用的文件或无法确认的内容时不执行 --zap，已勾选的残留仍由 Mole 清理。

visual-studio-code 这个 cask 的 zap 清单包含 ~/.vscode（扩展）和 ~/Library/Application Support/Code（设置、快捷键、片段和配置文件），还有缓存和偏好设置。执行 brew uninstall --cask --zap visual-studio-code 会把它们移到废纸篓。自己运行这条命令时，zap 清单不看 Mole 的勾选。先备份这些文件夹，或者卸载时不执行 zap：

brew uninstall --cask visual-studio-code

这个 cask 还会链接 code 和 code-tunnel 两个命令，Homebrew 移除应用时会一并移除这两个链接。

想完全从头开始时，删除全部用户数据

Microsoft 的完全卸载说明列了三个文件夹。删掉它们，VS Code 就回到安装之前的状态，所以只在做完上面的备份之后再动手。

更完整的步骤见 重置或卸掉 VS Code，不必先丢掉整套配置。

检查结果

应用进废纸篓后，运行下面几条只读命令：

pgrep -lf "Visual Studio Code.app"
command -v code
ls -d "$HOME/Library/Application Support/Code" ~/.vscode ~/.vscode-shared
grep -n "Visual Studio Code.app" ~/.zprofile ~/.bash_profile

• pgrep 没有输出，说明没有从 VS Code 启动的进程。列出进程，说明编辑器或某个辅助进程还开着。
• command -v code 打印出路径时，核对它是指向已移除的 VS Code.app，还是另一个渠道安装的可用命令。只在确认入口失效后处理那一个链接，不要删除 /usr/local/bin 或 Homebrew 的整层目录。没有输出只说明当前 PATH 找不到，不足以证明扩展和设置都不存在。
• ls -d 会打印仍然存在的数据文件夹，其余的提示「No such file or directory」。你打算保留配置时，这些文件夹还在是正常的。
• grep 有匹配，说明你曾按 Microsoft 的 Mac 安装说明手动把 VS Code 加进 PATH，到它指出的文件里删掉那一行。提示「No such file or directory」只表示那个配置文件不存在。

准备重装时保留 Code/User 和 ~/.vscode/extensions 的备份，确认项目目录里的 .vscode 没被当成应用残留删除。

Mole 会列出什么

以下是 Mole 对 Microsoft 官网下载版的处理：

• ~/Library/Application Support/Code/Cache 和 CachedData 默认勾选，按 com.microsoft.VSCode 存放的缓存、偏好设置和窗口恢复状态也默认勾选。
• 「通用 › 清理 › 卸载时一并移除数据和配置」默认关闭，此时 ~/.vscode、~/.vscode-shared 和整个 ~/Library/Application Support/Code 会列出但不勾选，开启后，Mole 确认只属于本次卸载应用的这些文件夹可以预先勾选，想保留设置和扩展就取消勾选，共享数据、受保护的浏览器资料和代理档案仍按各自的保护规则处理。

磁盘上的项目不在这张表里。

这次检查覆盖了什么

测试用的 Mac 上装着 VS Code，没有卸载。2026 年 9 月 22 日和 23 日，用 Mole 的开发构建对这份安装预览了卸载列表，没有删除任何东西：9 月 23 日列出 21 项，其中 18 项默认勾选；再和磁盘上属于 VS Code 的文件对照，没有发现漏项。Homebrew cask 和从备份重装都没有测试。