dotnet 命令

本文適用于: ✔️.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] [--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 --infodotnet --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 --helpdotnet 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 上的 Runtime Configuration Files (執行階段組態檔)。

  • --roll-forward <SETTING> **

    控制將向前復原套用至應用程式的方式。 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.json 檔案的路徑。 runtimeconfig.json檔案包含執行時間設定,通常名為< applicationname.runtimeconfig.json >。 如需詳細資訊,請參閱 .NET 執行時間組態設定

dotnet 命令

一般

Command 函式
dotnet build 建置 .NET 應用程式。
dotnet build-server 與組建所啟動的伺服器互動。
dotnet clean 清除組建輸出。
dotnet exec 執行 .NET 應用程式。
dotnet help 顯示命令更詳細的線上文件。
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 和執行時間版本的最新狀態。
dotnet sln 要在方案檔中新增、移除及列出專案的選項。
dotnet store 在執行階段套件存放區中儲存組件。
dotnet test 使用測試執行器執行測試。

專案參考

Command 函式
dotnet add reference 新增專案參考。
dotnet list reference 列出專案參考。
dotnet remove reference 移除專案參考。

NuGet 套件

Command 函式
dotnet add package 新增 NuGet 套件。
dotnet remove package 移除 NuGet 套件。

NuGet 命令

Command 函式
dotnet nuget delete 從伺服器刪除或取消列出套件。
dotnet nuget push 將套件推送至伺服器並發行。
dotnet nuget locals 清除或列出本機 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 update source 更新 NuGet 來源。

工作負載命令

Command 函式
dotnet workload install 安裝選擇性工作負載。
dotnet 工作負載清單 列出所有已安裝的工作負載。
dotnet workload repair 修復所有已安裝的工作負載。
dotnet 工作負載搜尋 列出選取的工作負載或所有可用的工作負載。
dotnet workload uninstall 卸載工作負載。
dotnet 工作負載更新 重新安裝所有已安裝的工作負載。

全域、工具路徑和本機工具命令

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

Command 函式
dotnet tool install 在您的電腦上安裝工具。
dotnet tool list 列出您電腦上目前安裝的所有全域、工具路徑或本機工具。
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

另請參閱