You need to enable JavaScript to run this app. 如何在PowerShell脚本中卸载旧版本.NET SDK与运行时?
优惠活动
大模型
产品
解决方案
定价
更多

如何在PowerShell脚本中卸载旧版本.NET SDK与运行时?

问题根因说明

抛出空引用异常不是操作失误导致的:dotnet-core-uninstall 工具的识别逻辑是扫描系统注册表中的MSI安装记录,当前设备上的所有.NET组件都是通过dotnet-install.ps1脚本部署到用户目录的非MSI安装包,本身没有在系统注册表写入卸载条目,工具无法匹配到可卸载的安装包信息,就会直接触发崩溃。
根据微软官方的工具适用范围说明,这类用户态脚本部署的组件,本身就不在工具的支持卸载列表内,反复调整命令参数也无法正常运行。

脚本部署组件的卸载操作方案

所有通过dotnet-install.ps1部署的用户态.NET组件,没有系统级的注册表残留、没有在Program Files目录放置共享文件,完全可以通过文件系统操作完成卸载:

  • 前置校验:分别执行dotnet --list-sdks、dotnet --list-runtimes确认所有已安装组件的实际路径,确认没有混装系统目录(C:\Program Files\dotnet)下的MSI部署组件,避免误删系统文件。
  • 全量清空旧版本场景:如果计划装完最新版本后完全不保留历史组件,直接删除%LOCALAPPDATA%\Microsoft\dotnet整个文件夹即可——这是dotnet-install.ps1无管理员权限运行时的默认安装根目录,删除该文件夹会连带清掉所有部署在该目录下的host、SDK、运行时组件,无残留。
  • 定向删除特定旧版本场景:如果需要保留部分兼容版本,精准删除对应版本的子目录即可:
    • SDK对应目录为 [dotnet安装根目录]\sdk\[版本号]
    • 运行时对应目录为 [dotnet安装根目录]\shared\[运行时类型]\[版本号],比如设备上的Microsoft.NETCore.App 5.0.2就对应shared\Microsoft.NETCore.App\5.0.2路径
  • 收尾清理:
    • 检查当前用户的PATH环境变量,移除指向旧dotnet安装目录的条目,避免后续命令调用到残留的可执行文件
    • 重新打开PowerShell窗口,执行dotnet --info确认所有旧版本路径已经不再被系统识别
流程优化建议

原本计划的操作顺序是「先装最新SDK、再卸载旧版本」,对于脚本部署的场景可以调整为「先清空旧的用户级dotnet安装目录、再执行最新版SDK的安装流程」,能避免旧版本目录的环境变量优先级干扰新安装的SDK正常运行。
*注:dotnet-core-uninstall 仅对两类安装源部署的组件有效:官方MSI安装包部署的系统级组件、Visual Studio 2019 16.3之前版本通过VS安装器部署的组件,脚本部署的场景无法通过该工具卸载。


内容的提问来源于stack exchange,提问作者Kyle Go

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 11:15:09