本文適用於： ✔️ .NET Core 3.1 SDK 與更新版本
名稱
dotnet - .NET CLI 的泛型驅動程式。
概要
若要取得可用命令和環境的相關信息：
dotnet [--version] [--info] [--list-runtimes] [--list-sdks]
dotnet -h|--help
若要執行命令（需要 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 <PATH>] [--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 [--arch <ARCH>]列印所叫
dotnet用 架構的已安裝 .NET 運行時間清單。 x86 版dotnet的清單只有 x86 運行時間，而 x64 版本的dotnet清單只有 x64 運行時間。.NET 10 和更新版本支援 自
--arch變數。 如果指定且與架構不同dotnet，請搜尋所指定架構的 .NET 安裝，並列印出該處安裝的任何運行時間。 允許的值包括arm64、x64和 x86。 dotnet/runtime 存放庫具有 有效架構值的完整清單。--list-sdks [--arch <ARCH>]列印所叫
dotnet用 架構的已安裝 .NET SDK 清單。 只有 x86 版dotnet的清單 x86 SDK，而 x64 版本的dotnet清單則只有 x64 SDK。.NET 10 和更新版本支援 自
--arch變數。 如果指定與架構不同dotnet，請搜尋所指定架構的 .NET 安裝，並列印出該處安裝的任何 SDK。 允許的值包括arm64、x64和 x86。 dotnet/runtime 存放庫具有 有效架構值的完整清單。-?|-h|--help列印出可用的命令清單。
執行命令的選項
下列選項適用於使用 命令 #D0。 例如，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- 如果缺少要求的主要版本，則向前復原至最低的主要版本，以及最低次要版本。 如果要求的主要版本存在，則會使用次要原則。 -
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.json 檔案的路徑。 runtimeconfig.json 檔案包含執行時間設定，且通常命名<為 applicationname>.runtimeconfig.json。 如需詳細資訊，請參閱
.NET 運行時間組態設定。
dotnet 命令
一般
| 指令 | 功能 |
|---|---|
| dotnet build | 建置 .NET 應用程式。 |
| dotnet build-server | 與組建啟動的伺服器互動。 |
| dotnet clean | 清除組建輸出。 |
| dotnet exec | 執行 .NET 應用程式。 |
| dotnet 說明 | 在在線顯示命令的詳細檔。 |
| dotnet migrate | 將有效的 Preview 2 專案移轉至 .NET Core SDK 1.0 專案。 |
| dotnet msbuild | 提供 MSBuild 命令行的存取權。 |
| dotnet new | 初始化指定範本的 C# 或 F# 專案。 |
| dotnet pack | 建立程式代碼的 NuGet 套件。 |
| dotnet publish | 發佈 .NET Framework 相依或獨立應用程式。 |
| dotnet restore | 還原指定應用程式的相依性。 |
| dotnet run | 從來源執行應用程式。 |
| dotnet sdk check | 顯示已安裝 SDK 和執行時間版本的 up-to日期狀態。 |
| dotnet sln | 在方案檔中新增、移除和列出項目的選項。 |
| dotnet store | 將元件儲存在運行時間套件存放區中。 |
| dotnet 測試 | 使用測試執行器執行測試。 |
項目參考
| 指令 | 功能 |
|---|---|
| 使用dotnet reference add命令 | 加入項目參考。 |
| dotnet 參考清單 | 列出項目參考。 |
| dotnet reference remove | 拿掉項目參考。 |
NuGet 套件
| 指令 | 功能 |
|---|---|
| dotnet package add | 新增 NuGet 套件。 |
| dotnet package list | 列出 NuGet 套件。 |
| dotnet package remove（移除套件） | 拿掉 NuGet 套件。 |
| dotnet package search | 搜尋 NuGet 套件。 |
NuGet 命令
| 指令 | 功能 |
|---|---|
| dotnet nuget delete | 從伺服器刪除或取消列出套件。 |
| dotnet nuget push | 將套件推送至伺服器並加以發佈。 |
| dotnet nuget 局部變數 | 清除或列出本機 NuGet 資源，例如 HTTP-request 快取、暫存快取或全機器通用套件資料夾。 |
| dotnet nuget add source | 新增 NuGet 來源。 |
| dotnet nuget disable source | 停用 NuGet 來源。 |
| dotnet nuget enable source | 啟用 NuGet 來源。 |
| dotnet nuget list source | 列出所有已設定的 NuGet 來源。 |
| dotnet nuget remove source | 拿掉 NuGet 來源。 |
| dotnet nuget 更新來源 | 更新 NuGet 來源。 |
工作負載命令
| 指令 | 功能 |
|---|---|
| dotnet 工作負載安裝 | 安裝選擇性工作負載。 |
| dotnet workload list | 列出所有已安裝的工作負載。 |
| dotnet workload repair | 修復所有已安裝的工作負載。 |
| dotnet workload search | 列出選取的工作負載或所有可用的工作負載。 |
| dotnet workload uninstall | 卸載工作負載。 |
| dotnet workload update | 重新安裝所有已安裝的工作負載。 |
全域、工具路徑和本機工具命令
工具是從 NuGet 套件安裝的控制台應用程式，並從命令提示字元叫用。 您可以自行撰寫工具，或安裝由第三方撰寫的工具。 工具也稱為全域工具、工具路徑工具和本機工具。 如需詳細資訊，請參閱 .NET 工具概觀。
| 指令 | 功能 |
|---|---|
| dotnet tool install | 在您的電腦上安裝工具。 |
| dotnet 工具清單 | 列出您電腦上目前已安裝的所有全域、工具路徑或本機工具。 |
| dotnet tool search | 搜尋 NuGet.org 名稱或元數據中具有指定搜尋字詞的工具。 |
| dotnet tool uninstall | 從您的電腦卸載工具。 |
| dotnet tool update | 更新電腦上安裝的工具。 |
其他工具
下列其他工具可在 .NET SDK 中取得：
| 工具 | 功能 |
|---|---|
| dev-certs | 建立和管理開發憑證。 |
| 英 孚 | Entity Framework Core 命令行工具。 |
| user-secrets | 管理開發使用者秘密。 |
| 看 | 當應用程式偵測到原始程式碼中的變更時，重新啟動或熱重載應用程式的檔案監看員。 |
如您每個工具的詳細資訊， 請輸入 dotnet <tool-name> --help。
範例
建立新的 .NET 主控台應用程式：
dotnet new console
在指定的目錄中建置專案及其相依性：
dotnet build
執行應用程式：
dotnet exec myapp.dll
dotnet myapp.dll
