卸载工具

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

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

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

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

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

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

注意

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

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

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 命令。

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

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

dotnet-core-uninstall remove 卸载由选项集合指定的 .NET SDK 和运行时。 版本 1.2 及更高版本可以卸载版本 5.0 或更早版本的 SDK 和运行时，而以前版本的工具可以卸载 3.1 及更早版本。

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

注意

请记住以下注意事项：

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

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

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

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

从安装目录中删除已下载的 dotnet-core-uninstall.tar.gz 文件。 如果将此文件的内容解压缩到其他目录中，请务必同时删除该内容。

--aspnet-runtime

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

--hosting-bundle

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

--runtime

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

--sdk

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

-v, --verbosity

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

--x64

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

--x86

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

--runtime

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

--sdk

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

-v, --verbosity

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

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

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

列出所有 x86 .NET SDK：

VERSION

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

提示

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

--all

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

--all-below [ ...]

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

--all-but [ ...]

除了那些指定版本外，删除所有 .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 版本相匹配的 .NET SDK 和运行时。

--runtime

仅删除 .NET 运行时。

--sdk

仅删除 .NET SDK。

-v, --verbosity

设置详细程度。 允许使用的值为 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 使用的版本。

注意

--all

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

--all-below [ ...]

删除低于指定版本的 .NET SDK 和运行时。 将保留指定的版本。

--all-but [ ...]

删除 .NET SDK 和运行时（指定版本除外）。

--all-but-latest

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

--all-lower-patches

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

--all-previews

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

--all-previews-but-latest

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

--major-minor

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

--runtime

仅删除 .NET 运行时。

--sdk

仅删除 .NET SDK。

-v, --verbosity

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

--force

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

注意

注意

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

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

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

VERSION

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

提示

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

--all

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

--all-below [ ...]

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

--all-but [ ...]

除了那些指定版本外，删除所有 .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 版本相匹配的 .NET SDK 和运行时。

--runtime

仅删除 .NET 运行时。

--sdk

仅删除 .NET SDK。

-v, --verbosity

设置详细程度。 允许使用的值为 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 使用的版本。

注意

--all

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

--all-below [ ...]

删除低于指定版本的 .NET SDK 和运行时。 将保留指定的版本。

--all-but [ ...]

删除 .NET SDK 和运行时（指定版本除外）。

--all-but-latest

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

--all-lower-patches

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

--all-previews

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

--all-previews-but-latest

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

--major-minor

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

--runtime

仅删除 .NET 运行时。

--sdk

仅删除 .NET SDK。

-v, --verbosity

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

-y, --yes

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

--force

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

注意

注意

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

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

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

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

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

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

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

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