本文适用于: ✔️ .NET Core 3.1 SDK 及更高版本
.NET 命令行接口 (CLI) 工具是用于开发、生成、运行和发布 .NET 应用程序的跨平台工具链。
. NET CLI 包含在 .NET SDK 中。 有关如何安装 .NET SDK 的详细信息,请参阅 安装 .NET。 安装 SDK 后,可以通过打开终端并在终端提示符处输入命令来运行 CLI 命令。
命令结构
CLI 命令结构由 驱动程序(“dotnet”)、 命令和可能命令 参数 和 选项组成。 在大多数 CLI 操作中,例如创建新的控制台应用程序并从命令行运行它,您都会看到这种模式。 以下命令显示从名为 my_app 的目录运行控制台应用时:
dotnet new console
dotnet build --output ./build_output
dotnet ./build_output/my_app.dll
司机
驱动程序名为 dotnet ,具有两个职责,即运行 依赖于框架的应用 或执行命令。
若要运行依赖于框架的应用,请在驱动程序后指定应用 .dll 文件的路径,而无需指定命令, dotnet /path/to/my_app.dll
例如。 从应用 DLL 所在的文件夹中执行命令时,只需执行 dotnet my_app.dll
。 有关详细信息,请参阅 dotnet 命令。
向驱动程序提供命令时, dotnet.exe
启动 CLI 命令执行过程。 例如:
dotnet build
首先,驱动程序确定要使用的 SDK 版本。 如果没有 global.json 文件,将使用最新版本的 SDK。 确定 SDK 版本后,它将执行该命令。
命令
该命令执行动作。 例如, dotnet build
生成代码。 dotnet publish
发布代码。 有关命令列表,请参阅 CLI 命令 部分。
论据
在命令行上传递的参数是调用命令的参数或命令指定选项的参数。 例如,当您执行dotnet publish my_app.csproj
时,my_app.csproj
参数用于指示要发布的项目,并将该参数传递给publish
命令。
选项
在命令行上传递的选项是调用的命令的选项。 例如,当你执行 dotnet publish --output /build_output
时,--output
选项及其由 /build_output
参数提供的值将传递给 publish
命令。
CLI 命令
默认情况下会安装以下命令:
基本命令
new
restore
build
publish
run
test
vstest
pack
migrate
clean
sln
help
store
watch
format
(自 .NET 6 SDK 起可用)
项目修改命令
package add
package list
package remove
package search
reference add
reference list
reference remove
NuGet 命令
nuget delete
nuget locals
nuget push
nuget add source
(自 .NET Core 3.1.200 SDK 起可用)nuget disable source
(自 .NET Core 3.1.200 SDK 起可用)nuget enable source
(自 .NET Core 3.1.200 SDK 起可用)nuget list source
(自 .NET Core 3.1.200 SDK 起可用)nuget remove source
(自 .NET Core 3.1.200 SDK 起可用)nuget update source
(自 .NET Core 3.1.200 SDK 起可用)nuget verify
(自 .NET 5 SDK 起可用)nuget trust
(自 .NET 5 SDK 起可用)nuget sign
(自 .NET 6 SDK 起可用)package search
(自 .NET 8.0.2xx SDK 起可用)nuget why
(自 .NET 8.0.4xx SDK 起可用)
工作负荷管理命令
workload
(自 .NET 7 SDK 起可用)workload config
(自 .NET 8.0.400 SDK 起可用)workload install
(自 .NET 6 SDK 起可用)workload list
(自 .NET 6 SDK 起可用)workload update
(自 .NET 6 SDK 起可用)workload restore
(自 .NET 6 SDK 起可用)workload repair
(自 .NET 6 SDK 起可用)workload uninstall
(自 .NET 6 SDK 起可用)workload search
(自 .NET 6 SDK 起可用)
高级命令
工具管理命令
工具是从 NuGet 包安装的控制台应用程序,并从命令提示符调用。 可以自行编写工具或安装由第三方编写的工具。 工具也称为全局工具、工具路径工具和本地工具。 有关详细信息,请参阅 .NET 工具概述。