dotnet 命令行常用命令

描述 dotnet 命令有两个函数，它提供了用于处理 .NET 项目的命令。

描述

dotnet 命令有两个函数：

• 它提供了用于处理 .NET 项目的命令。例如，dotnet build 生成项目。 每个命令定义自己的选项和参数。 所有命令都支持 --help 选项，用于打印有关如何使用命令的简短文档。
• 它运行 .NET 应用程序。指定应用程序 .dll 文件的路径以运行应用程序。 运行应用程序即意味着找到并执行入口点，对于控制台应用，入口点是 Main 方法。 例如，dotnet myapp.dll 运行 myapp 应用程序。 若要了解部署选项，请参阅 .NET 应用程序部署。

选项

可以使用不同的选项完成以下操作：

• 显示有关环境的信息。
• 运行命令。
• 运行应用程序。

用于显示环境信息和可用命令的选项

当自身使用 dotnet 时，可以使用以下选项，而无需指定要运行的命令或应用程序。 例如，dotnet --info 或 dotnet --version。 这些选项打印出有关环境的信息。

• --info打印出有关 .NET 安装和计算机环境（如当前操作系统）的详细信息，并提交 .NET 版本的 SHA。
• --version

打印出 dotnet 命令使用的 .NET SDK 版本，该版本可能受 global.json 文件的影响。 只有安装了 SDK 后才可用。

• --list-runtimes打印出已安装的 .NET 运行时的列表。 x86 版本的 SDK 只列出 x86 运行时，而 x64 版本的 SDK 只列出 x64 运行时。
• --list-sdks打印出已安装的 .NET SDK 的列表。
• -?|-h|--help打印可用命令列表。

用于运行命令的选项

以下选项适用于使用命令的 dotnet。 例如，dotnet build --help 或 dotnet build --verbosity diagnostic。

• -d|--diagnostics启用诊断输出。
• -v|--verbosity <LEVEL>设置命令的详细级别。 允许使用的值为 q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。 并非在每个命令中均受支持。 请参阅特定的命令页，确定此选项是否可用。
• -?|-h|--help打印出给定命令的文档。 例如，dotnet build --help 显示 build 命令的帮助。
• command options每个命令定义特定于该命令的选项。 有关可用选项的列表，请参阅特定命令页。

用于运行应用程序的选项

dotnet 运行应用程序时，可以使用以下选项。 例如 dotnet --roll-forward Major myapp.dll。

• --additionalprobingpath <PATH>包含要进行探测的探测策略和程序集的路径。 重复该选项以指定多个路径。
• --additional-deps <PATH>附加 .deps.json 文件的路径。 deps.json 文件包含依赖项、编译依赖项和用于解决程序集冲突的版本信息列表。 有关详细信息，请参阅 GitHub 上的运行时配置文件。

• --roll-forward <SETTING> **控制将前滚操作应用于应用的方式。 SETTING 可以为下列值之一。 如果未指定，则 Minor 为默认类型。
  • LatestPatch - 前滚到最高补丁版本。 这会禁用次要版本前滚。
  • Minor - 如果缺少所请求的次要版本，则前滚到最低的较高次要版本。 如果存在所请求的次要版本，则使用 LatestPatch 策略。
  • Major - 如果缺少所请求的主要版本，则前滚到最低的较高主要版本和最低的次要版本。 如果存在所请求的主要版本，则使用 Minor 策略。
  • LatestMinor - 即使存在所请求的次要版本，仍前滚到最高次要版本。 适用于组件托管方案。
  • LatestMajor - 即使存在所请求的主要版本，仍前滚到最高主要版本和最高次要版本。 适用于组件托管方案。
  • Disable - 不前滚。 仅绑定到指定的版本。 建议不要将此策略用于一般用途，因为它会禁用前滚到最新补丁的功能。 该值仅建议用于测试。

  除 Disable 外，所有设置都将使用可用的最高补丁版本。

  前滚行为还可以在项目文件属性、运行时配置文件属性和环境变量中进行配置。 有关详细信息，请参阅主版本运行时前滚。

• --fx-version <VERSION>用于运行应用程序的 .NET 运行时版本。

  此选项将重写应用程序 .runtimeconfig.json 文件中第一个框架引用的版本。 这意味着，仅当只有一个框架引用时，它才会按预期方式工作。 如果应用程序具有多个框架引用，则使用此选项可能会导致错误。

使用 exec 命令运行应用程序的选项

仅当 dotnet 使用 exec 命令运行应用程序时，以下选项才可用。 例如，dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll。

• --depsfile <PATH>deps.json 文件的路径。 .deps.json 文件是一个配置文件，其中包含有关运行应用程序所需的依赖项的信息。 此文件由 .NET SDK 生成。
• --runtimeconfig <PATH>runtimeconfig.template.json 文件的路径。 runtimeconfig.json 文件包含运行时设置，通常命名为 <applicationname>.runtimeconfig.json。 有关详细信息，请参阅 .NET 运行时配置设置。

dotnet 命令

常规

项目引用

NuGet 包

NuGet 命令

工作负载命令

全局、工具路径和本地工具命令

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

来源： dotnet 命令 - .NET CLI | Microsoft Learn

链接：https://learn.microsoft.com/zh-cn/dotnet/core/tools/dotnet