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 源和通过--add-source选项指定的源安装 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输出安装命令的帮助。 自 .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
