运行命令(需要 SDK 安装):
dotnet <COMMAND> [-d|--diagnostics] [-h|--help] [--verbosity <LEVEL>]
[command-options] [arguments]
运行应用程序:
dotnet [--additionalprobingpath <PATH>] [--additional-deps <PATH>]
[--fx-version <VERSION>] [--roll-forward <SETTING>]
<PATH_TO_APPLICATION> [arguments]
dotnet exec [--additionalprobingpath] [--additional-deps <PATH>]
[--depsfile <PATH>]
[--fx-version <VERSION>] [--roll-forward <SETTING>]
[--runtimeconfig <PATH>]
<PATH_TO_APPLICATION> [arguments]
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 上的运行时配置文件。
控制将前滚操作应用于应用的方式。 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 命令