.NET CLI 概觀

發行項
05/20/2023

本文適用于： ✔️.NET Core 2.1 SDK 和更新版本

.NET 命令列介面 (CLI) 是一個跨平臺工具鏈，可用於開發、建置、執行及發佈 .NET 應用程式。

.NET CLI 隨附于 .NET SDK。若要瞭解如何安裝 .NET SDK，請參閱安裝 .NET Core。

CLI 命令

預設會安裝下列命令：

基本命令

專案修改命令

進階命令

工具管理命令

tool install
tool list
tool update
tool restore 自 .NET Core SDK 3.0 起提供。
tool run 自 .NET Core SDK 3.0 起提供。
tool uninstall

工具是從 NuGet 套件安裝的主控台應用程式，並可透過命令提示字元叫用。您可以自行撰寫工具，也可以安裝由第三方撰寫的工具。工具也稱為全域工具、工具路徑工具和本機工具。如需詳細資訊，請參閱 .NET 工具概觀。

命令結構

CLI 命令結構包含驅動程式 ("dotnet")、命令，以及可能的命令引數及選項。您可以在大部分的 CLI 作業中看到此模式，例如從名稱為 my_app 的目錄執行以下命令，以建立新的主控台應用程式並從命令列執行它：

dotnet new console
dotnet build --output ./build_output
dotnet ./build_output/my_app.dll

驅動程式

驅動器的名稱是 dotnet，且有兩個責任：執行相依於架構的應用程式或執行命令。

若要執行相依於架構的應用程式，請在驅動器之後指定應用程式，例如 dotnet /path/to/my_app.dll。從應用程式的 DLL 所在的資料夾執行該命令時，只要執行 dotnet my_app.dll 即可。如果您想要使用特定版本的 .NET Runtime，請使用 --fx-version <VERSION> 選項 (請參閱 dotnet 命令參考) 。

當您提供命令給驅動器時，dotnet.exe 會啟動 CLI 命令執行程序。例如：

dotnet build

首先，驅動器會決定要使用的 SDK 版本。如果沒有 global.json 檔案，則會使用最新版的 SDK。這可能是預覽版或穩定的版本，視兩者中何者版本最新。確定 SDK 版本之後，就會開始執行命令。

Command

此命令會執行動作。例如，dotnet build 會建置程式碼。 dotnet publish 會發佈程式碼。命令是使用 dotnet {command} 慣例實作為主控台應用程式。

引數

您在命令列上傳遞的引數即為叫用命令的引數。例如，當您執行 dotnet publish my_app.csproj，my_app.csproj 引數表示要發佈的專案，並且會傳遞給 publish 命令。

選項

您在命令列上傳遞的選項即為叫用命令的選項。例如，當您執行 dotnet publish --output /build_output，--output 選項及其值會傳遞給 publish 命令。