visual studio uninstaller 是微软官方开源的深度清理工具，专用于彻底清除 vs 2012–2015 卸载残留，包括 msi 包、缓存目录、注册表项及 bundle 组件，解决版本冲突、磁盘占用和重装失败问题。
想彻底卸载 Visual Studio 并干净重装，避免旧版本残留导致新安装失败、磁盘空间被占满、组件冲突或启动报错？你不是在找“点几下卸载”的表面操作，而是需要一套覆盖标准卸载→深度清理→安全重装的完整路径。
用 Visual Studio 安装程序标准卸载
这是最稳妥的第一步，适用于所有 VS 2017 及之后版本（含 VS 2022），能移除主程序、已选工作负载和大部分用户数据。
打开 Windows 开始菜单，搜索并运行 Visual Studio Installer → 在“已安装”选项卡中找到目标版本（如 Visual Studio Community 2022）→ 点击右侧的 更多 → 选择 卸载 → 确认弹窗中的“确定”。
卸载过程耗时较长（通常 15–40 分钟），期间不要关闭安装程序窗口或重启电脑。它会调用内部 Bundle 引擎逐个卸载工作负载，比控制面板卸载更完整。
注意：此操作不会删除 Visual Studio 安装程序自身，也不会清理注册表项、MSI 缓存、符号服务器缓存或 %LocalAppData%\Microsoft\VisualStudio 下的用户配置文件——这些正是重装失败的常见根源。
手动清除 Visual Studio 安装程序
标准卸载完成后，必须单独卸载安装程序本体，否则残留的 setup.exe 仍可能干扰后续重装流程。
按 Win+S，输入“添加或删除程序”→ 在应用列表中找到 Microsoft Visual Studio Installer → 点击其右侧的三个点 → 选择“卸载”→ 确认执行。
这一步做完后，C:\Program Files (x86)\Microsoft Visual Studio\Installer\ 目录应已完全消失。如果该路径仍存在且含 setup.exe 文件，说明卸载未成功，需重启后再试一次。
使用 InstallCleanup.exe 彻底清空（仅限卸载失败时）
当安装程序打不开、卸载卡死、提示“无法访问包源”或反复修复无效时，才启用此微软官方兜底工具。它会强制删除所有 VS 实例的安装元数据和 MSI 产品代码，属于不可逆操作。
Visual Studio 18.8.1 官方固定版本安装引导程序，当前条目使用微软发布历史中的 Professional Web Installer，适合旧项目兼容、环境回退、复现特定构建链和排查版本差异等场景。
方法一：管理员命令行执行
关闭所有 VS 相关进程（包括后台的 vs_installerservice.exe）→ 按 Win+X 选择“终端（管理员）”→ 输入以下命令并回车：
cd /d "C:\Program Files (x86)\Microsoft Visual Studio\Installer" → InstallCleanup.exe -full
方法二：直接运行（推荐）
前往 C:\Program Files (x86)\Microsoft Visual Studio\Installer\ → 右键 InstallCleanup.exe → 选择“以管理员身份运行” → 等待命令行窗口自动完成并退出。
【警告】-full 参数会删除所有 VS 版本（2017/2019/2022）的安装记录，包括已卸载但未清理的旧实例。执行前请确认你不再需要任何历史版本的配置或扩展缓存。
手动清理残留文件与注册表（关键步骤）
InstallCleanup 不处理用户数据目录和注册表，这部分必须人工干预，否则重装后可能继承错误设置或崩溃行为。
第一步：删除用户配置目录
关闭所有 VS 进程 → 按 Win+R 输入 %LocalAppData%\Microsoft\VisualStudio → 删除整个 VisualStudio 文件夹 → 同样操作清理 %AppData%\Microsoft\VisualStudio 和 %Temp%\VSLogs。
第二步：清理注册表项（仅限高级用户）
按 Win+R 输入 regedit → 导航至 HKEY_CURRENT_USER\Software\Microsoft\VisualStudio → 找到对应版本子项（如 17.0_XXXXX、17.0_Config）→ 右键删除整项。
⚠️ 注意：不要碰 HKEY_LOCAL_MACHINE 下的 VisualStudio 键，那里属于系统级组件，误删可能导致 .NET SDK 或 C++ 构建工具异常。
第三步：清空 NuGet 全局包缓存
打开 PowerShell（非管理员），运行：nuget locals all -clear。这能释放 2–10GB 空间，并防止旧包签名冲突引发 restore 失败。
下载并安装新版 Visual Studio
访问 visualstudio.microsoft.com/zh-hans/downloads/ → 下载最新稳定版安装器（当前为 VS 2022 v17.12）→ 双击 setup.exe → 选择“安装”而非“修复”或“修改”→ 在工作负载页勾选所需内容（如“.NET 桌面开发”、“Python 开发”）→ 点击右下角“安装”按钮开始部署。
安装过程中，安装器会自动检测并重建缺失的共享组件（如 C++ 运行时、Windows SDK），无需手动预装。若提示“某些组件已在系统中”，可放心跳过——这是正常行为，表明清理已生效。
