dotnet new install

  • 發行項

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

名稱

dotnet new install - 安裝範本套件。

概要

dotnet new install <PATH|NUGET_ID>  [--interactive] [--add-source|--nuget-source <SOURCE>] [--force] 
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

描述

dotnet new install 命令會從提供的 PATH 或 NUGET_ID 安裝範本套件。 若您想安裝特定版本或發行前版本的範本套件，請以 <package-name>::<package-version> 格式指定版本。 根據預設，dotnet new 會對版本傳遞 *，這代表最新的穩定版套件。 如需詳細資訊，請參閱範例一節。

若您執行此命令時已安裝某個版本的範本套件，該範本套件會更新為指定版本。 如未指定版本，則套件會更新為最新的穩定版。 從 .NET SDK 6.0.100 開始，如果引數已指定版本，且已安裝該版本的 NuGet 封裝，則不會重新安裝。 若引數為 PATH 且已安裝套件，則不會重新安裝套件。

在 .NET SDK 6.0.100 之前，範本封裝會針對各個 .NET SDK 版本分別管理，包含修補檔版本。 例如，如果您在 .NET SDK 5.0.100 中使用 dotnet new --install 安裝範本封裝，則只會針對 .NET SDK 5.0.100 安裝該封裝。 該封裝的範本將無法在其他安裝於機器上的 .NET SDK 版本中使用。

從 .NET SDK 6.0.100 開始，已安裝的範本封裝可在您機器上安裝的 .NET SDK 更新版本中使用。 安裝於 .NET SDK 6.0.100 的範本封裝也可用於 .NET SDK 6.0.101、.NET SDK 6.0.200，以此類推。 不過，這些範本封裝將無法在 .NET SDK 6.0.100 之前的 .NET SDK 版本中使用。 如果要在 .NET SDK 舊版中使用安裝於 .NET SDK 6.0.100 或更新版本的範本封裝，您需要使用該 .NET SDK 版本的 dotnet new install 來安裝該封裝。

注意

自 .NET 7 SDK 起，dotnet new 語法進行了下列變更：

  • --list、--search、--install 與 --uninstall 選項變成 list、search、install 與 uninstall 子命令。
  • --update-apply 選項變成了 update 子命令。
  • 如要使用 --update-check，請搭配使用 update 子命令和 --check-only 選項。

先前版本中可用的其他選項仍可與各自的子命令搭配使用。 如需每項子命令的個別說明，可透過 -h 或 --help 選項取得：dotnet new <subcommand> --help 會列出子命令的所有支援選項。

此外，dotnet new 現可使用 TAB 鍵自動完成。 這項功能支援完成已安裝範本的名稱，以及所選範本提供的選項。 若要為 .NET SDK 啟用 TAB 鍵自動完成，請參閱啟用 TAB 鍵自動完成。

舊語法的範例：

  • 安裝最新版的 Azure Web 作業專案範本套件：

    dotnet new --install Microsoft.Azure.WebJobs.ProjectTemplates

引數

  • <PATH|NUGET_ID>

    要從中安裝範本套件的檔案系統資料夾或 NuGet 套件識別碼。 dotnet new 會嘗試透過 --add-source 選項，從目前工作目錄和指定來源可用的 NuGet 來源安裝 Nuget 套件。 若您想從 NuGet 來源安裝特定版本或發行前版本的範本套件，請以 <package-name>::<package-version> 格式指定版本。

選項。

  • --add-source|--nuget-source <SOURCE>

    根據預設，dotnet new install 會使用目前目錄中的 NuGet 組態檔階層，判斷可從哪個 NuGet 來源安裝套件。 如已指定 --nuget-source，則來源會新增至要檢查的來源清單中。
    如要針對目前的目錄檢查已設定的來源，請使用 dotnet nuget list source。 如需詳細資訊，請參閱常用的 NuGet 組態

    注意

    依據 NuGet 的 HttpsWhere 計劃，dotnet new 會逐步淘汰 http 摘要。 如果傳遞 http 摘要，則不會查詢封裝，而且會顯示警告。 如果有必要，--force 選項可用於覆寫此行為。

  • -d|--diagnostics

    啟用診斷輸出。 自 .NET SDK 7.0.100 起提供使用。

  • --force

    允許從指定的來源安裝範本套件，即使這些套件會覆寫來自其他來源的範本套件也一樣。 自 .NET SDK 7.0.100 起提供使用。

  • -h|--help

    列印 install 命令的說明。 自 .NET SDK 7.0.100 起提供使用。

  • --interactive

    可讓命令停止，並等候使用者輸入或進行動作。 例如完成驗證。 自 .NET 5.0 SDK 起提供使用。

  • -v|--verbosity <LEVEL>

    設定命令的詳細資訊層級。 允許的值為 q[uiet]、m[inimal]、n[ormal] 和 diag[nostic]。 自 .NET SDK 7.0.100 起提供使用。

範例

  • 安裝適用於 ASP.NET Core 的 SPA 範本最新版本：

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates

  • 安裝適用於 ASP.NET Core 的 SPA 範本 2.0 版：

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0

  • 使用互動模式，從自訂的 NuGet 來源安裝適用於 ASP.NET Core 的 SPA 範本 2.0 版：

    dotnet new --install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0 --add-source "https://api.my-custom-nuget.com/v3/index.json" --interactive

另請參閱