.NET Core 命令行接口 (CLI) 工具.NET Core command-line interface (CLI) tools
- 本文内容
安装Installation
CLI 命令CLI commands
命令结构Command structure
从 project.json 迁移Migration from project.json
请参阅See also

.NET Core 命令行接口 (CLI) 工具.NET Core command-line interface (CLI) tools

本文内容

.NET Core 命令行接口 (CLI) 工具是用于开发 .NET 应用程序的新型跨平台工具链。CLI 是更高级别的工具（如集成开发环境 (IDE)、编辑器和生成协调程序）可以驻留的基础。

安装Installation

使用本机安装程序或使用安装 shell 脚本：

本机安装程序主要用于开发人员的计算机，并使用每个受支持的平台的本机安装机制，例如，Ubuntu 上的 DEB 程序包或 Windows 上的 MSI 捆绑包。这些安装程序安装并配置环境，供开发人员立即使用，但是需要具有该计算机上的管理权限。可以在 .NET Core 安装指南中查看安装说明。
Shell 脚本主要用于设置生成服务器或希望安装工具但没有管理权限的情况。安装脚本不会在计算机上安装先决条件，必须手动安装它。有关详细信息，请参阅安装脚本引用主题。有关如何在你的持续集成 (CI) 生成服务器上设置 CLI 的信息，请参阅在持续集成 (CI) 中使用 .NET Core SDK 和工具。在默认情况下，SLI 以并行 (SxS) 方式安装，因此，因此，CLI 工具的多个版本可以在一个计算机上共存。有关确定在安装了多个版本的计算机上所使用的版本的类型，在驱动程序部分中对此有更详尽的介绍。

CLI 命令CLI commands

默认安装以下命令：

基本命令

CLI 采用可使你为项目指定其他工具的扩展性模型。有关详细信息，请参阅 .NET Core CLI 扩展性模型主题。

命令结构Command structure

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

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

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

驱动程序Driver

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

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

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

dotnet build

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

命令Command

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

自变量Arguments

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

选项Options

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

从 project.json 迁移Migration from project.json

如果使用预览版 2 工具生成基于 project.json 的项目，请查阅 dotnet 迁移主题，了解将你的项目迁移到 MSBuild/ .csproj 以使用版本工具的信息。对于预览版 2 工具发布之前所创建的 .NET Core 项目，请按照从 DNX 迁移到 .NET Core CLI (project.json) 中的指南手动更新项目，然后使用 dotnet migrate 或直接升级项目。

概述