如何彻底卸载Mac上的VSCode？

Question

如何彻底卸载Mac上的VSCode？许多用户在删除VSCode应用后，发现系统中仍残留配置文件、扩展插件和缓存数据。这些文件通常位于 `~/.vscode`、`~/Library/Application Support/Code`、`~/Library/Caches/com.microsoft.VSCode` 等路径下，影响重装或导致配置冲突。仅将应用拖入废纸篓无法实现“彻底卸载”。如何正确查找并清除所有相关文件和权限配置，成为用户面临的常见问题。尤其在需要重新配置开发环境或解决启动异常时，彻底清理显得尤为重要。

Answer 1

如何彻底卸载Mac上的VSCode？

1. 理解“彻底卸载”的真正含义

在macOS中，将应用程序从“应用程序”文件夹拖入废纸篓仅删除了主程序包（.app），而大量与用户配置、插件、缓存和权限相关的数据仍保留在系统中。这些残留文件可能导致：

• 重装后配置异常或行为不一致
• 扩展插件冲突或加载失败
• 启动缓慢或崩溃问题持续存在
• 占用不必要的磁盘空间

因此，“彻底卸载”意味着清除所有与VSCode相关的用户数据、缓存、偏好设置及系统级注册信息。

2. VSCode在macOS中的主要数据存储路径

Visual Studio Code 在 macOS 上遵循标准的用户目录结构，其核心数据分布在以下关键路径中：

路径	类型	说明
~/Applications/Visual Studio Code.app	应用本体	主程序包
~/Library/Application Support/Code	用户配置	包含 settings.json、keybindings、snippets 等
~/.vscode	项目级配置	工作区特定设置、任务、调试配置
~/Library/Caches/com.microsoft.VSCode	缓存数据	临时文件、渲染缓存、下载中间件
~/Library/Preferences/com.microsoft.VSCode.plist	偏好设置	GUI状态、窗口布局、更新记录
~/Library/Saved Application State/com.microsoft.VSCode.savedState	会话状态	上次关闭时的窗口状态
/private/var/folders/.../T/com.microsoft.VSCode.ShipIt	更新临时文件	自动更新过程中生成的临时数据
~/Library/LaunchAgents/com.microsoft.VSCode.launcher.plist	后台服务	用于命令行 code 命令支持

3. 手动清理流程：逐步执行的完整步骤

以下是手动彻底卸载 VSCode 的标准操作流程：

1. 退出正在运行的 VSCode 实例（使用 Cmd+Q）
2. 将 /Applications/Visual Studio Code.app 拖入废纸篓
3. 打开终端并执行以下命令以删除用户数据：

rm -rf ~/Library/Application\ Support/Code
rm -rf ~/.vscode
rm -rf ~/Library/Caches/com.microsoft.VSCode
rm -rf ~/Library/Preferences/com.microsoft.VSCode.plist
rm -rf ~/Library/Saved\ Application\ State/com.microsoft.VSCode.savedState
rm -f /usr/local/bin/code  # 如果存在符号链接
launchctl remove com.microsoft.VSCode.launcher || true
rm -f ~/Library/LaunchAgents/com.microsoft.VSCode.launcher.plist

此脚本覆盖了99%以上的残留项。

4. 自动化脚本方案：提升效率与可复用性

为便于团队部署或频繁环境重建，可编写自动化卸载脚本：

#!/bin/bash
# vscode-uninstall.sh - 彻底卸载 VSCode for macOS

echo "正在停止 VSCode 进程..."
pkill -f "Visual Studio Code" >/dev/null

echo "移除应用程序..."
sudo rm -rf "/Applications/Visual Studio Code.app"

echo "清理用户数据..."
rm -rf ~/Library/Application\\ Support/Code
rm -rf ~/.vscode
rm -rf ~/Library/Caches/com.microsoft.VSCode
rm -rf ~/Library/Preferences/com.microsoft.VSCode.plist
rm -rf ~/Library/Saved\\ Application\\ State/com.microsoft.VSCode.savedState
rm -f ~/Library/LaunchAgents/com.microsoft.VSCode.launcher.plist

echo "移除命令行链接..."
sudo rm -f /usr/local/bin/code

echo "卸载完成。建议清空废纸篓以释放空间。"

5. 验证卸载完整性：检查是否仍有残留

可通过以下命令验证系统中是否还存在 VSCode 相关文件：

find ~ -name "*code*" -type d -path "*/.*" 2>/dev/null | grep -i visual\|code
mdfind "kMDItemCFBundleIdentifier == 'com.microsoft.VSCode'"

若无输出，则表示已基本清理干净。

6. 使用第三方工具辅助清理（可选）

对于非技术用户或希望可视化操作者，推荐使用以下专业卸载工具：

• AppCleaner：免费且精准识别关联文件
• CleanMyMac X：商业软件，提供深度扫描功能
• AppZapper：老牌卸载工具，支持规则自定义

注意：使用此类工具时应确认其能识别 com.microsoft.VSCode 的完整依赖树。

7. 卸载后的权限与安全审计

macOS 中的应用可能请求过 Accessibility、Full Disk Access 等权限。即使应用被删除，授权记录仍保留在系统中。

前往：系统设置 → 隐私与安全性 → 安全性，检查以下类别中是否有残留条目：

• 辅助功能（Accessibility）
• 完全磁盘访问（Full Disk Access）
• 自动化（Automation）
• 输入监视（Input Monitoring）

如发现“Visual Studio Code”条目但无对应应用，可点击减号（-）手动移除。

8. 流程图：彻底卸载 VSCode 的决策路径

graph TD
            A[开始卸载 VSCode] --> B{VSCode 是否正在运行?}
            B -- 是 --> C[强制退出: Cmd+Q 或 pkill]
            B -- 否 --> D[删除 .app 文件]
            C --> D
            D --> E[删除用户配置目录]
            E --> F[清除缓存与偏好设置]
            F --> G[移除命令行符号链接]
            G --> H[清理 LaunchAgent 服务]
            H --> I[检查系统权限残留]
            I --> J[验证文件是否完全清除]
            J --> K[完成卸载]

9. 常见陷阱与高级注意事项

• 多版本共存：用户可能安装了 Visual Studio Code、Visual Studio Code - Insiders 或通过 Homebrew 安装的版本，需分别处理。
• 符号链接污染：若曾通过 code --install-extension 安装插件，部分全局符号链接可能未清除。
• 容器开发场景：使用 Dev Containers 时，Docker 卷中可能保留了扩展缓存，建议清理 ~/.docker/volumes 中相关卷。
• 企业策略配置：某些组织通过 MDM 推送策略，需联系IT部门确认是否存在托管配置文件。

10. 重新安装前的最佳实践建议

在完成彻底卸载后，若计划重新安装，建议遵循以下流程：

1. 重启系统以释放所有句柄
2. 清空废纸篓
3. 从官网 code.visualstudio.com 下载最新稳定版
4. 首次启动时选择“干净启动”，避免导入旧配置
5. 逐步恢复扩展和设置，便于排查潜在问题