ASP.NET Core 命令行界面

.NET Core 命令行界面(CLI)是一种新的跨平台工具,用于创建、恢复包、构建、运行和发布 .NET 应用程序。

我们创建了第一个 ASP.NET Core 应用程序。Visual Studio 在内部使用此 CLI 还原、生成和发布应用程序。其他更高级别的 IDE、编辑器和工具可以使用 CLI 来支持 .NET Core 应用程序。

针对选定平台,.NET Core CLI 与 .NET Core SDK 一起安装。所以我们不需要在开发机器上单独安装它。我们可以通过在 Windows 中打开命令提示符并编写 dotnet 并按 Enter 键来验证 CLI 是否正确安装。如果它显示如下所示的用法和帮助,则表示它安装正确。


命令结构

以下是命令结构。

dotnet <command> <argument> <option>

所有命令都以名为 dotnet 的驱动程序开始。驱动程序开始执行指定的命令。在 dotnet 之后,我们可以提供命令(也称为动词)来执行特定操作。每个命令后面都可以跟着参数和选项。以下是 .NET Core 2.x CLI命令。

基础命令描述
new基于指定的模板创建新项目、配置文件或解决方案。
restore恢复项目的依赖关系和工具。
build生成项目及其所有依赖项。
Run在没有任何显式编译或启动命令的情况下运行源代码。
publish将应用程序及其依赖项打包到文件夹中,以便部署到宿主系统。
test执行单元测试。
vtest从指定文件运行测试。
pack将代码打包到 NuGet 包中。
clean清理项目的输出。
sln修改 .NET Core 解决方案文件。
help显示指定命令的帮助
store将指定的程序集存储在运行时包存储中。
项目修改命令描述
add package向项目添加包引用。
add reference添加项目对项目(P2P)引用。
remove package从项目中删除包引用。
remove reference删除项目引用
list reference列出所有项目到项目的引用
高级命令描述
nuget delete从服务器上删除或取消列出包。
nuget locals清除或列出本地 NuGet 资源。
nuget push将包推送到服务器并发布。
msbuild生成项目及其所有依赖项。
dotnet install script用于安装 .NET Core CLI 工具和共享运行时的脚本。

让我们使用命令行界面创建、还原、构建和运行 .NET Core 控制台应用程序,而不使用 Visual Studio。


创建新项目

要创建一个新的 .NET Core 项目,我们必须使用 new 命令,后跟模板名称参数。我们可以使用 CLI 创建控制台、类库、web、mvc、webapi、razor、angular、react等项目。使用控制台模板创建新的 .NET Core 控制台应用程序。

下面将在当前目录中创建与当前目录同名的新控制台项目。

dotnet new console

以下命令创建名为 MyConsoleApp 的新控制台项目。-n 或 —name 选项指定项目的名称。

dotnet new console -n MyConsoleApp

以下命令将创建名为 MyConsoleApp 的新控制台应用程序到 MyProjects 目录。-o 或 —output 选项用于指定应在其中生成项目的输出目录。

dotnet new console -n MyConsoleApp -o C:\MyProjects

创建项目后,在命令提示符下导航到项目目录,以应用特定于项目的命令,在本例中为 C:\MyConsoleApp


添加包引用

出于不同的目的,我们经常需要添加 NuGet 包引用。例如,应用以下命令将 Newtonsoft.json 包添加到控制台项目中。

C:\MyConsoleApp>dotnet add package Newtonsoft.json

这将增加 Newtonsoft.json 包。我们可以通过打开 .csproj 文件来验证它。


还原程序包

要还原程序包或更新现有程序包,我们可以使用下面的 restore 命令。

C:\MyConsoleApp>dotnet restore

生成项目

要构建新项目或现有项目,请应用 C:\MyConsoleApp>dotnet 构建命令。


运行项目

要运行控制台项目,请应用如下所示的 dotnetrun 命令。


获取帮助

我们可以通过在要获取帮助的命令末尾键入 -h-help 来获取有关任何 .NET Core CLI 命令的帮助。例如,dotnet new-h 将显示有关新命令、参数和选项的帮助,如下所示。

因此,我们可以使用 .NET Core 命令行界面来创建、恢复包、构建、运行和发布不同类型的 .NET Core 应用程序。