本文适用于： ✔️ .NET Core 3.1 SDK 及更高版本
名称
dotnet tool update - 更新计算机上的指定 .NET 工具 。
概要
dotnet tool update <PACKAGE_ID> -g|--global
[--add-source <SOURCE>] [--all] [--allow-downgrade]
[--configfile <FILE>]
[--disable-parallel] [--framework <FRAMEWORK>]
[--ignore-failed-sources] [--interactive]
[--no-cache] [--prerelease]
[-v|--verbosity <LEVEL>] [--version <VERSION>]
dotnet tool update <PACKAGE_ID> --tool-path <PATH>
[--add-source <SOURCE>] [--all] [--allow-downgrade]
[--configfile <FILE>]
[--disable-parallel] [--framework <FRAMEWORK>]
[--ignore-failed-sources] [--interactive]
[--no-cache] [--prerelease]
[-v|--verbosity <LEVEL>] [--version <VERSION>]
dotnet tool update <PACKAGE_ID> --local
[--add-source <SOURCE>] [--all] [--allow-downgrade]
[--configfile <FILE>]
[--disable-parallel] [--framework <FRAMEWORK>]
[--ignore-failed-sources] [--interactive]
[--no-cache] [--prerelease]
[--tool-manifest <PATH>]
[-v|--verbosity <LEVEL>] [--version <VERSION>]
dotnet tool update -h|--help
DESCRIPTION
该 dotnet tool update 命令提供了一种将计算机上的 .NET 工具更新到包的最新稳定版本的方法。 该命令卸载并重新安装工具，从而有效地更新该工具。 若要使用此命令，请指定以下选项之一：
- 若要更新默认位置中安装的全局工具，请使用
--global该选项 - 若要更新自定义位置中安装的全局工具，请使用
--tool-path此选项。 - 若要更新本地工具，请使用
--local此选项。
论据
PACKAGE_ID包含要更新的 .NET 全局工具的 NuGet 包的名称/ID。 可以使用 dotnet 工具列表 命令找到包名称。
选项
--add-source <SOURCE>添加安装过程中要使用的其他 NuGet 包源。 系统会并行访问这些源，而不是按某种优先级顺序依次访问。 如果同一个包和版本在多个源中，则选取速度最快的源。 有关详细信息，请查看安装 NuGet 包时会发生什么情况？。
--all更新所有工具。
--allow-downgrade允许在安装或更新 .NET 工具包时降级包。 禁止显示警告：“请求的版本 x.x.x 低于现有版本 x.x.x。
--configfile <FILE>要使用的 NuGet 配置文件 (nuget.config)。 如果指定，则只使用此文件中的设置。 如果不指定，将使用当前目录中的配置文件的层次结构。 有关详细信息，请参阅常见的 NuGet 配置。
--disable-parallel防止并行还原多个项目。
--framework <FRAMEWORK>指定要为其更新工具 的目标框架 。
-g|--global指定更新适用于用户范围工具。 不能与
--tool-path选项一起使用。 省略--global并--tool-path指定要更新的工具是本地工具。
-?|-h|--help打印出有关如何使用命令的说明。
--ignore-failed-sources将包源失败视为警告。
--interactive允许命令停止并等待用户输入或操作。 例如，完成身份验证。
--local更新工具和本地工具清单。 不能与
--global选项或--tool-path选项一起使用。--no-cache不要缓存包和 HTTP 请求。
--prerelease包括预发行版。
--tool-manifest <PATH>清单文件的路径。
--tool-path <PATH>指定安装全局工具的位置。 路径可以是绝对的，也可以是相对的。 不能与
--global选项一起使用。 省略--global并--tool-path指定要更新的工具是本地工具。
-v|--verbosity <LEVEL>设置命令的详细级别。 允许使用的值为
q[uiet]、m[inimal]、n[ormal]、d[etailed]和diag[nostic]。 有关详细信息，请参阅 LoggerVerbosity。
--version <VERSION>要更新到的工具包的版本范围。 这不能用于降级版本，必须先
uninstall更新版本。从 .NET 8.0 开始，
--version Major.Minor.Patch指特定的 major.minor.patch 版本，包括未列出的版本。 若要改用特定 major.minor 版本的最新版本，请使用--version Major.Minor.*。
例子
dotnet tool update -g dotnetsay更新 dotnetsay 全局工具。
dotnet tool update dotnetsay --tool-path c:\global-tools更新位于特定 Windows 目录中的 dotnetsay 全局工具。
dotnet tool update dotnetsay --tool-path ~/bin更新位于特定 Linux/macOS 目录中的 dotnetsay 全局工具。
dotnet tool update dotnetsay更新为当前目录安装的 dotnetsay 本地工具。
dotnet tool update -g dotnetsay --version 2.0.*将 dotnetsay 全局工具更新为最新修补程序版本，其中包含主版本
2和次要版本的修补程序0。dotnet tool update -g dotnetsay --version (2.0.*,2.1.4)将 dotnetsay 全局工具更新为指定范围内
(> 2.0.0 && < 2.1.4)的最低版本，将安装版本2.1.0。 有关语义版本控制范围的详细信息，请参阅 NuGet 打包版本范围。
