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使用。 它支援完成已安裝的範本名稱和所選範本提供的選項。
若要開啟 .NET SDK 的索引標籤自動完成，請參閱 啟用索引標籤自動完成。
舊語法的範例：
安裝最新版的 Azure Web 作業專案範本套件：
dotnet new --install Microsoft.Azure.WebJobs.ProjectTemplates
參數
<PATH|NUGET_ID>檔案系統或 NuGet 套件識別碼上的資料夾，用來安裝範本套件的來源。
dotnet new嘗試從目前工作目錄可用的 NuGet 來源安裝 NuGet 套件，以及透過 [--add-source] 選項指定的來源。 如果您想要從 NuGet 來源安裝範本套件的特定版本或發行前版本，請以<package-name>::<package-version>格式指定版本。
選項
--add-source|--nuget-source <SOURCE>根據預設，
dotnet new install會使用來自目前目錄的 NuGet 組態檔階層來判斷可從中安裝套件的 NuGet 來源。 如果指定了--nuget-source，來源將會新增至要檢查的來源清單。 若要檢查目前目錄的已設定來源，請使用dotnet nuget list source。 如需詳細資訊，請參閱 一般 NuGet 組態。注意
在 NuGet 的 Https 隨處 方案之後，
dotnet new會逐步淘汰http摘要。 如果傳遞http摘要，則不會查詢套件，而且會顯示警告。--force選項可用來視需要覆寫此行為。-d|--diagnostics啟用診斷輸出。 自 .NET SDK 7.0.100 起提供。
--force允許從指定的來源安裝範本套件，即使它們會覆寫來自另一個來源的範本套件也一樣。 自 .NET SDK 7.0.100 起提供。
-h|--help列印安裝命令的說明。 自 .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
