本文适用于:✔️ .NET 6 SDK 及更高版本
名字
dotnet new install - 安装模板包。
概要
dotnet new install <PATH|NUGET_ID> [--interactive] [--add-source|--nuget-source <SOURCE>] [--force] [--prerelease]
[-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]
描述
dotnet new install 命令从提供的 PATH 或 NUGET_ID 安装模板包。 如果要安装模板包的特定版本或预发行版版本,请以 <package-name>@<package-version>格式指定版本。 (在 .NET 9.0.200 SDK 中弃用::冒号分隔符@。)默认情况下,dotnet new传递 * 作为版本,表示最新的稳定包版本。 有关详细信息,请参阅 示例 部分。
如果运行此命令时已安装模板包的版本,模板包将更新为指定版本。 如果未指定版本,则包将更新到最新的稳定版本,除非指定 --prerelease 了该选项。
从 .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
警告
触发时,模板可以运行 MSBuild 代码和其他任意代码。 不要安装或运行不受信任的 .NET 模板。
包签名验证
启用签名验证后, dotnet new install 在安装之前验证从 NuGet 源下载的已签名模板包。 验证适用于已配置的其他 NuGet 源,但不适用于直接从本地 .nupkg 文件或文件夹安装的包。
验证取决于操作系统:
| 操作系统 | 默认行为 | Configuration |
|---|---|---|
| Windows | 已启用 | 不能对 DOTNET_NUGET_SIGNATURE_VERIFICATION.. |
| Linux | 已启用 | 设置为 DOTNET_NUGET_SIGNATURE_VERIFICATION=false 禁用验证。 |
| macOS | Disabled | 设置为 DOTNET_NUGET_SIGNATURE_VERIFICATION=true 启用验证。 有关平台限制,请参阅 NuGet 签名包验证 。 |
启用验证后,除非适用的 NuGet 配置集 signatureValidationMode 设置为 require,否则接受未签名的包,或者源声明其所有包都是存储库签名的。 有关配置客户端策略的信息,请参阅 signatureValidationMode。
如果签名验证失败,则不会安装包。 此选项 --force 不会绕过签名验证。 运行命令 --diagnostics 以查看验证详细信息。 有关证书存储要求和故障排除,请参阅 NuGet 签名包验证。 还可以使用 .. 显式 dotnet nuget verify验证下载的包。
成功验证不保证模板可以安全运行。 有关此行为更改和受影响的 SDK 功能带的详细信息,请参阅 模板包安装验证 NuGet 签名。
参数
<PATH|NUGET_ID>要从中安装模板包的文件系统或 NuGet 包标识符上的文件夹。
dotnet new尝试从可用于当前工作目录的 NuGet 源和通过--add-source选项指定的源安装 NuGet 包。 如果要从 NuGet 源安装模板包的特定版本或预发行版版本,请以<package-name>@<package-version>格式指定版本。 (在 .NET 9.0.200 SDK 中弃用::冒号分隔符@。)
选项
--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打印出有关如何使用命令的说明。
-
--interactive允许命令停止并等待用户输入或操作。 例如,若要完成身份验证。
--prerelease如果未指定模板包版本,请选择最新的可用版本,包括预发行版。 如果指定包版本,例如
Contoso.Templates@2.0.0-preview.3,该命令将选择该确切版本。 自 .NET SDK 11 起可用。-
-v|--verbosity <LEVEL>设置命令的详细级别。 允许使用的值为
q[uiet]、m[inimal]、n[ormal]、d[etailed]和diag[nostic]。 有关详细信息,请参阅 LoggerVerbosity。
例子
安装适用于 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