.NET CLI 概述

项目
09/22/2022

本文适用于： ✔️ .NET Core 2.1 SDK 及更高版本

.NET 命令行接口 (CLI) 工具是用于开发、生成、运行和发布 .NET 应用程序的跨平台工具链。

.NET CLI 附带了 .NET SDK。若要了解如何安装 .NET SDK，请参阅安装 .NET Core。

CLI 命令

默认安装以下命令：

基本命令

项目修改命令

高级命令

工具管理命令

tool install
tool list
tool update
tool restore 自 .NET Core SDK 3.0 起可用。
tool run 自 .NET Core SDK 3.0 起可用。
tool uninstall

工具是控制台应用程序，它们从 NuGet 包中安装并从命令提示符处进行调用。你可自行编写工具，也可安装由第三方编写的工具。工具也称为全局工具、工具路径工具和本地工具。有关详细信息，请参阅 .NET 工具概述。

命令结构

CLI 命令结构包含驱动程序（“dotnet”）和命令，还可能包含命令参数和选项。在大部分 CLI 操作中可看到此模式，例如创建新控制台应用并从命令行运行该应用，因为从名为 my_app 的目录中执行时，显示以下命令：

dotnet new console
dotnet build --output ./build_output
dotnet ./build_output/my_app.dll

驱动程序

驱动程序名为 dotnet，并具有两项职责，即运行依赖于框架的应用或执行命令。

若要运行依赖于框架的应用，请在驱动程序后指定应用，例如，dotnet /path/to/my_app.dll。从应用的 DLL 驻留的文件夹执行命令时，只需执行 dotnet my_app.dll 即可。如果要使用特定版本的 .NET 运行时，请使用 --fx-version <VERSION> 选项（请参阅 dotnet 命令参考）。

为驱动程序提供命令时，dotnet.exe 启动 CLI 命令执行过程。例如：

dotnet build

首先，驱动程序确定要使用的 SDK 版本。如果没有 global.json 文件，则使用可用的最新版本 SDK。这有可能是预览版或稳定版，具体取决于计算机上的最新版本。确定 SDK 版本后，它便会执行命令。

命令

由命令执行操作。例如，dotnet build 生成代码。 dotnet publish 发布代码。使用 dotnet {command} 约定将命令作为控制台应用程序实现。

自变量

在命令行上传递的参数是被调用的命令的参数。例如，执行 dotnet publish my_app.csproj 时，my_app.csproj 参数指示要发布的项目，并被传递到 publish 命令。

选项

在命令行上传递的选项是被调用的命令的选项。例如，执行 dotnet publish --output /build_output 时，--output 选项及其值被传递到 publish 命令。