本文適用於: ✔️ .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 套件安裝的控制台應用程式,並從命令提示字元叫用。 您可以自行撰寫工具,或安裝由第三方撰寫的工具。 工具也稱為全域工具、路徑工具和本地工具。 如需詳細資訊,請參閱 #A1 #B0 .NET 工具概觀。