.NET Core基础学习——.NET Core SDK与命令行（CLI）工具

2023年8月18日 255次阅读

.NET Core SDK与命令行（CLI）工具

作为开发者，如果想要开发.net core跨平台应用程序，必须安装.NET Core SDK。

.NET Core SDK 概述

.NET Core 软件开发工具包 (SDK) 是一组库和工具，使开发人员能够创建 .NET Core 应用程序和库。这是开发人员最可能获取的包。

它包含下列组件：

.NET Core 命令行工具，用于生成应用程序
.NET Core（库和运行时），用于生成并运行应用程序
dotnet 驱动程序，用于运行 CLI 命令和应用程序

注：.NET Core SDK已经包含了运行时，所以不需要再额外安装运行时。

.NET Core 命令行（CLI）工具

.NET Core 命令行接口 (CLI) 工具是用于开发 .NET 应用程序的新型跨平台工具链。使用它可以用于构建、测试，运行和发布应用程序，CLI 是更高级别的工具（如集成开发环境 (IDE)、编辑器和生成协调程序）可以驻留的基础。在默认情况下，SLI 以并行 (SxS) 方式安装，因此，可以在一个计算机上有多个版本的 CLI 工具。

只要你安装了.NET Core SDK工具包，就可以使用CLI。

CLI命令

CLI命令不需要死记硬背，你只需要记住dotnet help命令即可，使用该命令可以查看详细的说明。

PS C:UsersSmallZ> dotnet help
.NET 命令行工具 (2.1.401)
使用情况: dotnet [runtime-options] [path-to-application] [arguments]

执行 .NET Core 应用程序。

runtime-options:
  --additionalprobingpath <path>     要探测的包含探测策略和程序集的路径。
  --additional-deps <path>           指向其他 deps.json 文件的路径。
  --fx-version <version>             要用于运行应用程序的安装版共享框架的版本。
  --roll-forward-on-no-candidate-fx  已启用“不前滚到候选共享框架”。

path-to-application:
  要执行的应用程序 .dll 文件的路径。

使用情况: dotnet [sdk-options] [command] [command-options] [arguments]

执行 .NET Core SDK 命令。

sdk-options:
  -d|--diagnostics  启用诊断输出。
  -h|--help         显示命令行帮助。
  --info            显示 .NET Core 信息。
  --list-runtimes   显示安装的运行时。
  --list-sdks       显示安装的 SDK。
  --version         显示使用中的 .NET Core SDK 版本。

SDK 命令:
  add               将包或引用添加到 .NET 项目。
  build             生成 .NET 项目。
  build-server      与由生成版本启动的服务器进行交互。
  clean             清理 .NET 项目的生成输出。
  help              显示命令行帮助。
  list              列出 .NET 项目的项目引用。
  migrate           将 project.json 项目迁移到 MSBuild 项目。
  msbuild           运行 Microsoft 生成引擎(MSBuild)命令。
  new               创建新的 .NET 项目或文件。
  nuget             提供其他 NuGet 命令。
  pack              创建 NuGet 包。
  publish           发布 .NET 项目进行部署。
  remove            从 .NET 项目中删除包或引用。
  restore           还原 .NET 项目中指定的依赖项。
  run               生成并运行 .NET 项目输出。
  sln               修改 Visual Studio 解决方案文件。
  store             在运行时包存储中存储指定的程序集。
  test              使用 .NET 项目中指定的测试运行程序运行单元测试。
  tool              安装或管理扩展 .NET 体验的工具。
  vstest            运行 Microsoft 测试引擎(VSTest)命令。

捆绑工具中的其他命令:
  dev-certs         创建和管理开发证书。
  ef                Entity Framework Core 命令行工具。
  sql-cache         SQL Server 缓存命令行工具。
  user-secrets      管理开发用户密码。
  watch             启动文件观察程序，它会在文件发生更改时运行命令。

运行 "dotnet [command] --help"，获取有关命令的详细信息。
PS C:UsersSmallZ>

你也可以直接查看官方文档来了解每个命令对应的选项和参数的详细说明：https://docs.microsoft.com/zh-cn/dotnet/core/tools/

指定版本的CLI工具

默认情况下，将会运行计算机上安装的最新版本的CLI工具，例如，在目录test中使用dotnet命令查看CLI工具的版本：

C:	est>dotnet --version
2.1.401

如果安装了多个版本的CLI，并且不想运行最新版本，可以在当前工作目录中创建global.json文件，并确保它至少包含以下内容：

{
	"sdk":{
		"version":"2.0.0"
	}
}

例如，在上述中的文件夹test中添加包含该内容的global.json文件后，再次执行命令，将会以指定版本的CLI工具运行：

C:	est>dotnet --version
2.0.0

注意：此处version属性的值确定要使用的CLI工具的版本，该版本等同于SDK版本，但是与应用程序将要使用的.net core运行时版本并不相同。运行时版本在项目文件（.csproj）中指定，如下：

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp2.1</TargetFramework>
  </PropertyGroup>

</Project>

你可以在VS中，右击项目属性，在应用程序选项卡的用户界面中进行配置（对应项为目标框架），你也可以手动的编辑上述中的.csproj项目文件，更改对应的TargetFramework值即可。

常用CLI命令

这里按照实际应用中的使用顺序进行概述。

参考资源

本文后续会随着知识的积累不断补充和更新，内容如有错误，欢迎指正。

最后一次更新时间：2018-09-05

算法网

.NET Core基础学习——.NET Core SDK与命令行（CLI）工具

.NET Core SDK与命令行（CLI）工具

.NET Core SDK 概述

.NET Core 命令行（CLI）工具

CLI命令

指定版本的CLI工具

常用CLI命令

dotnet new

dotnet restore

dotnet build

dotnet run

dotnet test

dotnet publish

dotnet pack

dotnet migrate

dotnet clean

参考资源