解决Visual Studio 2022 Professional重装失败问题及卸载由Visual Studio安装的残留.NET SDK

阿华AIGC实验室

2026-4-2

我之前也碰到过类似的糟心情况——卸载VS后重装卡壳，还留着清不掉的组件，给你整理几个亲测有效的解决步骤，一步步来应该能搞定：

一、先解决Setup.Configuration组件的1638安装错误

错误提示Return code: 1638说明你的机器上已经装了同版本的Microsoft.VisualStudio.Setup.Configuration组件，导致新安装包无法覆盖，咱们先把它清干净：

用官方Visual Studio卸载工具彻底清理残留
微软提供的专门卸载工具比第三方工具更适配VS的组件逻辑：
- 搜索「Visual Studio Installer Cleanup Utility」在微软官网下载
- 运行工具时选择「Full」模式，它会扫描并清理所有VS相关的残留组件、配置文件和注册表项，包括那个卡壳的Setup.Configuration组件
- 工具运行完成后，务必重启电脑
如果工具没解决，手动卸载残留的MSI组件
要是官方工具没清掉目标组件，咱们用MSI命令行手动处理：
- 按下Win+R，输入cmd后右键选择「以管理员身份运行」命令提示符
- 先查询已安装的Setup.Configuration组件的产品代码：
```
wmic product where "name like '%Visual Studio Setup Configuration%'" get IdentifyingNumber, Name, Version
```
- 找到对应的产品GUID，执行卸载命令（把{你的产品GUID}替换为查询到的内容）：
```
msiexec /x {你的产品GUID} /qn REBOOT=ReallySuppress
```
- 卸载完成后，再尝试重新运行Visual Studio安装程序

如果控制面板里找不到.NET SDK的卸载入口，或者卸载按钮灰色不可用，试试这两个方法：

用.NET官方卸载工具精准清理
微软有专门的.NET组件卸载工具，能识别由VS安装的SDK版本：
- 搜索「.NET Uninstall Tool」在微软官网下载
- 以管理员身份打开命令提示符，先查看已安装的.NET版本列表：
```
dotnet-core-uninstall list
```
- 找到标注为由Visual Studio安装的目标SDK版本，执行卸载命令（替换成你要卸载的版本号）：
```
dotnet-core-uninstall remove --version 6.0.413 --sdk
```
手动删除残留文件和注册表项（谨慎操作）
要是工具没搞定，只能手动清理（修改注册表前一定要备份！）：
- 删除文件：找到.NET SDK的安装目录，一般在C:\Program Files\dotnet\sdk和C:\Program Files (x86)\dotnet\sdk，删掉对应版本的文件夹
- 清理注册表：按下Win+R输入regedit打开注册表编辑器，依次检查以下路径，删除对应SDK版本的条目：
  - HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\Setup\Packages
  - HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP