dotnet tool install

  • 發行項

本文適用於： ✔️ .NET Core 3.1 SDK 與更新版本

名稱

dotnet tool install - 在您的機器上安裝指定的 .NET 工具。

概要

dotnet tool install <PACKAGE_NAME> -g|--global
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

描述

dotnet tool install 命令可讓您在機器上安裝 .NET 工具。 若要使用此命令，請指定下列其中一個安裝選項：

  • 若要在預設位置安裝全域工具，請使用 --global 選項。
  • 若要在自訂位置安裝全域工具，請使用 --tool-path 選項。
  • 若要安裝本機工具，請省略 --global 與 --tool-path 選項。

安裝位置

全域工具

當您指定 -g 或 --global 選項時，通用工具預設會安裝在下列目錄中：

OS 路徑
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

會在這些資料夾中為每個全域安裝的工具產生可執行檔，雖然實際工具二進位檔案巢狀於同層級 .store 目錄的深處。

--tool-path 工具

具有明確工具路徑的工具將儲存在指定 --tool-path 參數指向的任何位置。 它們的儲存方式與全域工具相同：可執行二進位檔案和實際二進位檔案位於同層級 .store 目錄中。

本機工具

本機工具儲存在 NuGet 全域目錄中，無論您將其設定為什麼。 每個本機工具的 $HOME/.dotnet/toolResolverCache 中都有填充碼檔案，這些檔案指向該位置內的工具所在位置。

本機工具的參考會新增至目前目錄下 .config 目錄中的 dotnet-tools.json 檔案。 如果資訊清單檔尚不存在，請使用 --create-manifest-if-needed 選項或執行以下命令建立它：

dotnet new tool-manifest

如需詳細資訊，請參閱安裝本機工具。

引數

  • PACKAGE_NAME

    包含要安裝的 .NET 工具之 NuGet 套件的名稱識別碼。

選項。

  • --allow-downgrade

    允許在安裝或更新 .NET 工具套件時降級套件。 隱藏警告：「要求的版本 x.x.x 低於現有的 x.x.x 版」。

  • -a|--arch <ARCHITECTURE>

    指定目標結構。 這是用於設定執行階段識別碼 (RID) 的速記語法，其中提供的值會與預設 RID 合併。 例如在 win-x64 機器上，指定 --arch x86 將 RID 設定為 win-x86。

  • --add-source <SOURCE>

    新增其他 NuGet 套件來源以在安裝期間使用。 系統會平行存取摘要，而非按照優先順序逐一存取。 如果相同的套件和版本存在於多個摘要中，則最快速的摘要會勝出。 如需詳細資訊，請參閱安裝 NuGet 套件後會發生哪些情況？。

  • --configfile <FILE>

    要使用的 NuGet 組態檔 (nuget.config)。 若已指定，僅會使用此檔案中的設定。 若未指定，則將使用當前目錄中組態檔的階層。 如需詳細資訊，請參閱常見的 NuGet 組態。

  • --create-manifest-if-needed

    適用於本機工具。 從 .NET 8 SDK 開始提供。 若要尋找資訊清單，搜尋演算法在目錄樹狀樹中搜尋 dotnet-tools.json 或包含 dotnet-tools.json 檔案的 .config 資料夾。

    如果找不到工具資訊清單，並且 --create-manifest-if-needed 選項設定為 false，則會發生 CannotFindAManifestFile 錯誤。

    如果找不到工具資訊清單，並且 --create-manifest-if-needed 選項設定為 true，則工具會自動建立資訊清單。 它為資訊清單選擇資料夾，如下所示：

    • 向上查看目錄樹狀，搜尋包含 .git 子資料夾的目錄。 如有找到目錄，請在該目錄中建立資訊清單。
    • 如果上一個步驟找不到目錄，請逐步執行目錄樹狀目錄，搜尋具有 .sln 或 .git 檔案的目錄。 如有找到目錄，請在該目錄中建立資訊清單。
    • 如果前兩個步驟都沒有找到目錄，請在目前工作目錄中建立資訊清單。

    如需指令清單如何找到的詳細資訊，請參閱 安裝本機工具。

  • --disable-parallel

    避免平行還原多項專案。

  • --framework <FRAMEWORK>

    指定要更新其工具的目標 Framework。 根據預設，.NET SDK 會嘗試選擇最適當的目標 Framework。

  • -g|--global

    指定安裝為使用者範圍。 無法與 --tool-path 選項合併使用。 省略 --global 和 --tool-path 即可指定本機工具安裝。

  • -?|-h|--help

    列印如何使用命令的描述。

  • --ignore-failed-sources

    將套件來源失敗視為警告。

  • --interactive

    可讓命令停止，並等候使用者輸入或進行動作。 例如完成驗證。

  • --local

    更新工具與本機工具資訊清單。 無法與 --global 選項或 --tool-path 選項合併使用。

  • --no-cache

    請勿快取封裝和 HTTP 要求。

  • --prerelease

    包含發行前版本套件。

  • --tool-manifest <PATH>

    資訊清單檔的路徑。

  • --tool-path <PATH>

    指定要安裝通用工具的位置。 PATH 可為絕對路徑或相對路徑。 如果 PATH 不存在，命令會嘗試建立它。 省略 --global 和 --tool-path 即可指定本機工具安裝。

  • -v|--verbosity <LEVEL>

    設定命令的詳細資訊層級。 允許的值為 q[uiet]、m[inimal]、n[ormal]、d[etailed] 和 diag[nostic]。 如需詳細資訊，請參閱LoggerVerbosity。

  • --version <VERSION_NUMBER>

    要安裝的工具版本。 根據預設，會安裝最新的穩定套件版本。 請使用此選項來安裝預覽版本或較舊版本的工具。

    從 .NET 8.0 開始，--version Major.Minor.Patch 是指特定 major/minor/patch 版本 (包括未列出的版本)。 若要改為取得特定 major/minor 版本的最新版本，請使用 --version Major.Minor.*。

範例

  • dotnet tool install -g dotnetsay

    在預設位置中安裝 dotnetsay 做為通用工具。

  • dotnet tool install dotnetsay --tool-path c:\global-tools

    將 dotnetsay 安裝為特定 Windows 目錄中的全域工具。

  • dotnet tool install dotnetsay --tool-path ~/bin

    將 dotnetsay 安裝為特定 Linux/macOS 目錄中的全域工具。

  • dotnet tool install -g dotnetsay --version 2.0.0

    安裝 2.0.0 版的 dotnetsay 做為通用工具。

  • dotnet tool install dotnetsay

    安裝 dotnetsay 做為目前目錄的本機工具。

  • dotnet tool install -g --verbosity minimal

    將 dotnetsay 安裝為全域工具，詳細程度最低。 全域工具的預設詳細程度為無訊息。

另請參閱