.NET 卸载工具

  • 项目

可使用 .NET 卸载工具 (dotnet-core-uninstall) 从系统中删除 .NET SDK 和运行时。 可使用选项集合来指定要卸载的版本。

该工具支持 Windows 和 macOS。 目前不支持 Linux。

在 Windows 上，该工具只能卸载使用以下安装程序之一安装的 SDK 和运行时：

  • .NET SDK 和运行时安装程序。
  • Visual studio 安装程序的版本早于 Visual Studio 2019 版本 16.3。

在 macOS 上，该工具只能卸载位于 /usr/local/share/dotnet 文件夹中的 SDK 和运行时。

由于这些限制，该工具可能无法卸载计算机上的所有 .NET SDK 和运行时。 可以使用 dotnet --info 命令来查找所有安装的 .NET SDK 和运行时，包括此工具无法删除的 SDK 和运行时。 dotnet-core-uninstall list 命令显示可以通过该工具卸载的 SDK。

注意

目前，.NET 卸载工具不支持 .NET 8+。 有关该工具的发布计划的详细信息，请参阅 GitHub - dotnet-uninstall-tool 路线图。

安装工具

可以从工具的发布页面下载 .NET 卸载工具，然后在 dotnet/cli-lab GitHub 存储库中找到源代码。

注意

此工具需要提升才能卸载 .NET SDK 和运行时。 因此，应将其安装在写入保护的目录中，如 Windows 上的 C:\Program Files 或 macOS 上的 /usr/local/bin。 有关详细信息，请参阅提升的 Dotnet 命令访问权限和详细安装说明。

运行该工具

以下步骤说明了运行卸载工具的建议方法：

步骤 1 - 显示安装的 .NET SDK 和运行时

dotnet-core-uninstall list 命令列出了已安装的 .NET SDK 和运行时，可以通过此工具将其删除。 Visual Studio 可能需要某些 SDK 和运行时，它们将显示出来，并说明为何不建议将其卸载。

注意

在大多数情况下，dotnet-core-uninstall list 命令的输出将与 dotnet --info 输出中的已安装版本列表不匹配。 具体而言，此工具将不会显示通过 zip 文件安装的版本，也不会显示由 Visual Studio（Visual Studio 2019 版本 16.3 或更高版本）托管的版本。 检查某个版本是否由 Visual Studio 托管的一种方法是在 Add or Remove Programs 中查看该版本，由 Visual Studio 托管的版本在显示名称中会以这种方式标记。

有关详细信息，请参阅本文后续部分的 list 命令。

步骤 2 - 执行试运行

dotnet-core-uninstall dry-run 和 dotnet-core-uninstall whatif 命令显示将根据提供的选项删除的 .NET SDK 和运行时，而无需执行卸载。 这些命令是同义词。

有关详细信息，请参阅本文后续部分的 dry-run 和 whatif 命令。

步骤 3 - 卸载 .NET SDK 和运行时

dotnet-core-uninstall remove 卸载由选项集合指定的 .NET SDK 和运行时。

由于此工具具有破坏性行为，因此强烈建议在运行 remove 命令之前执行试运行。 使用 remove 命令时，试运行将显示要删除的 .NET SDK 和运行时。 请参阅是否应删除版本？了解哪些 SDK 和运行时可以安全删除。

注意

请记住以下注意事项：

  • 此工具可以卸载计算机上 global.json 文件所需的 .NET SDK 版本。 可以从下载 .NET 页重新安装 .NET SDK。
  • 此工具可以卸载计算机上依赖于框架的应用程序所需的 .NET 运行时版本。 可以从下载 .NET 页重新安装 .NET 运行时。
  • 此工具可以卸载 Visual Studio 所依赖的 .NET SDK 和运行时版本。 如果中断 Visual Studio 安装，请在 Visual Studio 安装程序中运行“修复”以返回到工作状态。

默认情况下，所有命令都将保留 Visual Studio 或其他 SDK 可能需要的 .NET SDK 和运行时。 可以通过将这些 SDK 和运行时显式列出为参数或使用 --force 选项来卸载这些 SDK 和运行时。

此工具需要提升才能卸载 .NET SDK 和运行时。 在 Windows 上的管理员命令提示符中运行此工具，在 macOS 上则通过 sudo 运行。 dry-run 和 whatif 命令不需要提升。

有关详细信息，请参阅本文后续部分的 remove 命令。

步骤 4 - 删除 NuGet 回退文件夹（可选）

在某些情况下，你不再需要 NuGetFallbackFolder，可能希望将其删除。 有关详细信息，请参阅删除 NuGetFallbackFolder。

卸载工具

  1. 打开“添加或删除程序”。
  2. 搜索 Microsoft .NET SDK Uninstall Tool。
  3. 选择“卸载”。

list 命令

摘要

dotnet-core-uninstall list [options]

选项

  • --aspnet-runtime

    列出可通过此工具卸载的所有 ASP.NET 运行时。

  • --hosting-bundle

    列出可通过此工具卸载的所有 .NET 托管捆绑包。

  • --runtime

    列出可通过此工具卸载的所有 .NET 运行时。

  • --sdk

    列出可通过此工具卸载的所有 .NET SDK。

  • -v, --verbosity <LEVEL>

    设置详细程度。 允许使用的值为 q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。 默认值为 normal。

  • --x64

    列出可通过此工具卸载的所有 x64 .NET SDK 和运行时。

  • --x86

    列出可通过此工具卸载的所有 x86 .NET SDK 和运行时。

示例

  • 列出可通过此工具删除的所有 .NET SDK 和运行时：

    dotnet-core-uninstall list

  • 列出所有 x64 .NET SDK 和运行时：

    dotnet-core-uninstall list --x64

  • 列出所有 x86 .NET SDK：

    dotnet-core-uninstall list --sdk --x86

dry-run 和 whatif 命令

摘要

dotnet-core-uninstall dry-run [options] [<VERSION>...]

dotnet-core-uninstall whatif [options] [<VERSION>...]

自变量

VERSION

要卸载的指定版本。 可以逐一列出多个版本，用空格分隔。 此外还支持响应文件。

提示

响应文件是在命令行上放置所有版本的替代方法。 它们是文本文件，通常具有 *.rsp 扩展名，每个版本都在单独的行上列出。 若要为 VERSION 参数指定响应文件，请使用后面紧跟响应文件名的 @ 字符。

选项

  • --all

    删除所有 .NET SDK 和运行时。

  • --all-below <VERSION>[ <VERSION>...]

    仅删除版本小于指定版本的 .NET SDK 和运行时。 仍安装指定版本。

  • --all-but <VERSIONS>[ <VERSION>...]

    除了那些指定版本外，删除所有 .NET SDK 和运行时。

  • --all-but-latest

    删除 .NET SDK 和运行时（最高版本除外）。

  • --all-lower-patches

    删除由较高版本的修补程序取代的 .NET SDK 和运行时。 此选项保护 global.json 文件。

  • --all-previews

    删除标记为预览版的 .NET SDK 和运行时。

  • --all-previews-but-latest

    删除标记为预览版的 .NET SDK 和运行时（最高预览版除外）。

  • --aspnet-runtime

    仅删除 ASP.NET 运行时。

  • --hosting-bundle

    仅删除 .NET 运行时和托管捆绑包。

  • --major-minor <MAJOR_MINOR>

    删除与指定 major.minor 版本相匹配的 .NET SDK 和运行时。

  • --runtime

    仅删除 .NET 运行时。

  • --sdk

    仅删除 .NET SDK。

  • -v, --verbosity <LEVEL>

    设置详细程度。 允许使用的值为 q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。 默认值为 normal。

  • --x64

    必须与 --sdk、--runtime 和 --aspnet-runtime 结合使用才能删除 x64 SDK 或运行时。

  • --x86

    必须与 --sdk、--runtime 和 --aspnet-runtime 结合使用才能删除 x86 SDK 或运行时。

  • --force

    强制删除可能由 Visual Studio 使用的版本。

注意

  • 只需 --sdk、--runtime、--aspnet-runtime 和 --hosting-bundle 中的一个。
  • --all、--all-below、--all-but、--all-but-latest、--all-lower-patches、--all-previews、--all-previews-but-latest、--major-minor 和 [<VERSION>...] 除外。
  • 如果未指定 --x64 或 --x86，则同时删除 x64 和 x86。

示例

注意

默认情况下，Visual Studio 或其他 SDK 可能需要的 .NET SDK 和运行时不会包含在 dotnet-core-uninstall dry-run 输出中。 在下面的示例中，某些指定的 SDK 和运行时可能不会包含在输出中，具体取决于计算机的状态。 要包含所有 SDK 和运行时，请将它们显式列出为参数或使用 --force 选项。

  • 试运行删除已被较高版本的修补程序取代的所有 .NET 运行时：

    dotnet-core-uninstall dry-run --all-lower-patches --runtime

  • 试运行删除低于版本 2.2.301 的所有 .NET SDK：

    dotnet-core-uninstall whatif --all-below 2.2.301 --sdk

remove 命令

摘要

dotnet-core-uninstall remove [options] [<VERSION>...]

自变量

VERSION

要卸载的指定版本。 可以逐一列出多个版本，用空格分隔。 此外还支持响应文件。

提示

响应文件是在命令行上放置所有版本的替代方法。 它们是文本文件，通常具有 *.rsp 扩展名，每个版本都在单独的行上列出。 若要为 VERSION 参数指定响应文件，请使用后面紧跟响应文件名的 @ 字符。

选项

  • --all

    删除所有 .NET SDK 和运行时。

  • --all-below <VERSION>[ <VERSION>...]

    仅删除版本小于指定版本的 .NET SDK 和运行时。 仍安装指定版本。

  • --all-but <VERSIONS>[ <VERSION>...]

    除了那些指定版本外，删除所有 .NET SDK 和运行时。

  • --all-but-latest

    删除 .NET SDK 和运行时（最高版本除外）。

  • --all-lower-patches

    删除由较高版本的修补程序取代的 .NET SDK 和运行时。 此选项保护 global.json 文件。

  • --all-previews

    删除标记为预览版的 .NET SDK 和运行时。

  • --all-previews-but-latest

    删除标记为预览版的 .NET SDK 和运行时（最高预览版除外）。

  • --aspnet-runtime

    仅删除 ASP.NET 运行时。

  • --hosting-bundle

    仅删除 .NET 托管捆绑包。

  • --major-minor <MAJOR_MINOR>

    删除与指定 major.minor 版本相匹配的 .NET SDK 和运行时。

  • --runtime

    仅删除 .NET 运行时。

  • --sdk

    仅删除 .NET SDK。

  • -v, --verbosity <LEVEL>

    设置详细程度。 允许使用的值为 q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。 默认值为 normal。

  • --x64

    必须与 --sdk、--runtime 和 --aspnet-runtime 结合使用才能删除 x64 SDK 或运行时。

  • --x86

    必须与 --sdk、--runtime 和 --aspnet-runtime 结合使用才能删除 x86 SDK 或运行时。

  • -y, --yes

    执行命令而不需要进行是或否确认。

  • --force

    强制删除可能由 Visual Studio 使用的版本。

注意

  • 只需 --sdk、--runtime、--aspnet-runtime 和 --hosting-bundle 中的一个。
  • --all、--all-below、--all-but、--all-but-latest、--all-lower-patches、--all-previews、--all-previews-but-latest、--major-minor 和 [<VERSION>...] 除外。
  • 如果未指定 --x64 或 --x86，则同时删除 x64 和 x86。

示例

注意

默认情况下，将保留 Visual Studio 或其他 SDK 可能需要的 .NET SDK 和运行时。 在下面的示例中，可能保留某些指定的 SDK 和运行时，具体取决于计算机的状态。 要删除所有 SDK 和运行时，请将它们显式列出为参数或使用 --force 选项。

  • 删除除版本 3.0.0-preview6-27804-01 之外的所有 .NET 运行时，无需进行是或否确认：

    dotnet-core-uninstall remove --all-but 3.0.0-preview6-27804-01 --runtime --yes

  • 删除所有 .NET Core 1.1 SDK，无需进行是或否确认：

    dotnet-core-uninstall remove --sdk --major-minor 1.1 -y

  • 删除没有控制台输出的 .NET Core 1.1.11 SDK：

    dotnet-core-uninstall remove 1.1.11 --sdk --yes --verbosity q

  • 删除可由此工具安全删除的所有 .NET SDK：

    dotnet-core-uninstall remove --all --sdk

  • 删除此工具可删除的所有 .NET SDK，包括 Visual Studio 可能需要的 SDK（不推荐）：

    dotnet-core-uninstall remove --all --sdk --force

  • 删除 versions.rsp 响应文件中指定的所有 .NET SDK：

    dotnet-core-uninstall remove --sdk @versions.rsp

    versions.rsp 文件的内容如下所示：

    2.2.300
2.1.700