如何管理 .NET Core 工具
本文适用于： ✔️ .NET Core 2.1 SDK 及更高版本
.NET Core 工具是一种特殊的 NuGet 包，其中包含控制台应用程序。 可以通过以下方式在计算机上安装该工具：
-
作为全局工具。
工具二进制文件安装在添加到 PATH 环境变量的默认目录中。 无需指定工具位置即可从计算机上的任何目录调用该工具。 工具的一个版本用于计算机上的所有目录。
-
作为自定义位置中的全局工具（也称为工具路径工具）。
工具二进制文件安装在你指定的位置中。 可以从安装目录调用该工具，也可以通过提供具有命令名称的目录或将目录添加到 PATH 环境变量来调用该工具。 工具的一个版本用于计算机上的所有目录。
-
作为本地工具（适用于 .NET Core SDK 3.0 及更高版本）。
工具二进制文件安装在默认目录中。 可以从安装目录或其任何子目录调用该工具。 不同目录可以使用同一工具的不同版本。
.NET CLI 使用清单文件跟踪哪些工具作为本地工具安装到目录。 将清单文件保存到源代码存储库的根目录中后，参与者可以克隆存储库并调用用于安装清单文件中列出的所有工具的单个 .NET Core CLI 命令。
.NET Core 工具在完全信任环境中运行。 除非你信任工具作者，否则请勿安装 .NET Core 工具。
查找工具
目前，.NET Core 没有工具搜索功能。 以下是查找工具的一些方法：
- 请参阅 natemcmaster/dotnet-tools GitHub 存储库中的工具列表。
- 使用 ToolGet 搜索 .NET 工具。
- 在 dotnet/aspnetcore GitHub 存储库的工具目录中查看 ASP.NET Core 团队创建的工具的源代码。
- 在 .NET Core dotnet 诊断工具中了解诊断工具。
- 搜索 NuGet 网站。 但是，NuGet 网站尚无可用于仅搜索工具包的功能。
查看作者和统计信息
由于 .NET Core 工具在完全信任环境中运行，并且全局工具已添加到 PATH 环境变量，因此它们的功能非常强大。 请勿下载不信任的人提供的工具。
如果该工具在 NuGet 中托管，可以通过搜索该工具来查看作者和统计信息。
安装全局工具
若要将工具作为全局工具安装，请使用 dotnet tool install 的 -g 或 --global 选项，如以下示例中所示：
.NET Core CLI
dotnet tool install -g dotnetsay输出显示用于调用该工具和已安装的版本的命令，类似于以下示例：
You can invoke the tool using the following command: dotnetsay
Tool 'dotnetsay' (version '2.1.4') was successfully installed.工具二进制文件的默认位置取决于操作系统：
| (OS) | 路径 |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
首次运行 SDK 时，会将此位置添加到用户的路径，因此，无需指定工具位置即可从任何目录调用全局工具。
工具访问特定于用户，而不针对计算机全局。 全局工具仅适用于安装了该工具的用户。
安装自定义位置中的全局工具
若要将工具作为自定义位置中的全局工具安装，请使用 dotnet tool install 的 --tool-path 选项，如以下示例中所示。
在 Windows 上：
dotnet tool install dotnetsay --tool-path c:\dotnet-tools在 Linux 或 macOS 上：
dotnet tool install dotnetsay --tool-path ~/bin.NET Core SDK 不将此位置自动添加至 PATH 环境变量。 若要调用工具路径工具，必须确保可使用以下方法之一来调用命令：
- 将安装目录添加到 PATH 环境变量。
- 调用该工具时，指定该工具的完整路径。
- 从安装目录调用该工具。
安装本地工具
适用于 .NET Core 3.0 SDK 及更高版本。
若要安装仅用于本地访问的工具（对于当前目录和子目录），必须将其添加到工具清单文件。 若要创建工具清单文件，请运行 dotnet new tool-manifest 命令：
dotnet new tool-manifest此命令在“.config” 目录下创建一个名为“dotnet-tools.json” 的清单文件。 若要将本地工具添加到清单文件，请使用 dotnet tool install 命令并省略 --global 和 --tool-path 选项，如以下示例中所示 ：
dotnet tool install dotnetsay命令输出显示新安装的工具所在的清单文件，类似于以下示例：
You can invoke the tool from this directory using the following command:
dotnet tool run dotnetsay
Tool 'dotnetsay' (version '2.1.4') was successfully installed.
Entry is added to the manifest file /home/name/botsay/.config/dotnet-tools.json.以下示例显示安装了两个本地工具的清单文件：
{
"version": 1,
"isRoot": true,
"tools": {
"botsay": {
"version": "1.0.0",
"commands": [
"botsay"
]
},
"dotnetsay": {
"version": "2.1.3",
"commands": [
"dotnetsay"
]
}
}
}通常将本地工具添加到存储库的根目录。 将清单文件签入到存储库后，从存储库中签出代码的开发人员会获得最新的清单文件。 若要安装清单文件中列出的所有工具，请运行 dotnet tool restore 命令：
dotnet tool restore输出表明还原了哪些工具：
Tool 'botsay' (version '1.0.0') was restored. Available commands: botsay
Tool 'dotnetsay' (version '2.1.3') was restored. Available commands: dotnetsay
Restore was successful.安装特定工具版本
若要安装工具的预发布版本或特定版本，请使用 --version 选项指定版本号，如以下示例中所示：
dotnet tool install dotnetsay --version 2.1.3使用工具
用于调用工具的命令可能不同于安装的包的名称。 若要显示计算机上目前安装的所有工具，请使用 dotnet tool list 命令：
dotnet tool list输出显示每个工具的版本和命令，类似于以下示例：
Package Id Version Commands Manifest
-------------------------------------------------------------------------------------------
botsay 1.0.0 botsay /home/name/repository/.config/dotnet-tools.json
dotnetsay 2.1.3 dotnetsay /home/name/repository/.config/dotnet-tools.json如本示例中所示，列表显示了本地工具。 若要查看全局工具，请使用 --global 选项，若要查看工具路径工具，请使用 --tool-path 选项。
调用全局工具
对于全局工具，请单独使用工具命令。 例如，如果命令为 dotnetsay 或 dotnet-doc，则可以使用以下命令调用该工具：
dotnetsay
dotnet-doc如果命令以前缀 dotnet- 开头，则调用该工具的另一种方法是使用 dotnet 命令并省略工具命令前缀。 例如，如果命令为 dotnet-doc，则可以使用以下命令调用该工具：
dotnet doc但是，在以下情况下，不能使用 dotnet 命令来调用全局工具：
- 全局工具和本地工具具有以
dotnet-为前缀的相同命令。 - 你希望从本地工具范围内的目录调用全局工具。
在这种情况下，dotnet doc 和 dotnet dotnet-doc 调用本地工具。 若要调用全局工具，请单独使用命令：
dotnet doc调用工具路径工具
若要调用使用 tool-path 选项安装的全局工具，请确保该命令可用，如本文前面所述。
调用本地工具
若要调用本地工具，必须从安装目录使用 dotnet 命令。 可以使用长格式 (dotnet tool run <COMMAND_NAME>) 或短格式 (dotnet <COMMAND_NAME>)，如以下示例中所示：
dotnet tool run dotnetsay
dotnet dotnetsay如果命令以 dotnet- 为前缀，则可以在调用该工具时包括或省略前缀。 例如，如果命令为 dotnet-doc，则可以使用以下任何示例调用本地工具：
dotnet tool run dotnet-doc
dotnet dotnet-doc
dotnet doc更新工具
更新工具涉及卸载该工具并重新安装它的最新稳定版。 若要更新工具，请使用具有用于安装该工具的相同选项的 dotnet tool update 命令：
dotnet tool update --global <packagename>
dotnet tool update --tool-path <packagename>
dotnet tool update <packagename>对于本地工具，SDK 通过在当前目录和父目录中查找来查找包含包 ID 的第一个清单文件。 如果任何清单文件中都没有此类包 ID，SDK 会将新条目添加到最近的清单文件。
卸载工具
使用具有用于安装该工具的相同选项的 dotnet tool uninstall 命令删除工具：
dotnet tool uninstall --global <packagename>
dotnet tool uninstall --tool-path<packagename>
dotnet tool uninstall <packagename>对于本地工具，SDK 通过在当前目录和父目录中查找来查找包含包 ID 的第一个清单文件。
获取帮助和疑难解答
若要获取可用 dotnet tool 命令的列表，请输入以下命令：
dotnet tool --help若要获取工具使用说明，请输入以下命令之一，或访问工具的网站：
<command> --help
dotnet <command> --help如果工具无法安装或运行，请参阅排查 .NET Core 工具使用问题。
