本文适用于:✔️ .NET 6 SDK 及更高版本
Name
dotnet new search - 在 NuGet.org 上搜索支持的 dotnet new 模板。
概要
dotnet new search <TEMPLATE_NAME>
dotnet new search [<TEMPLATE_NAME>] [--author <AUTHOR>] [-lang|--language <language>]
[--package <PACKAGE>] [--tag <TAG>] [--type <TYPE>]
[--columns <author|language|tags|type>] [--columns-all]
[-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]
Description
该 dotnet new search 命令在 NuGet.org 上搜索支持的 dotnet new 模板。 <指定TEMPLATE_NAME> 后,搜索包含指定名称的模板。
注释
从 .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 的选项卡完成,请参阅 启用选项卡完成。
旧语法的示例:
搜索 NuGet.org 匹配“we”子字符串并支持 F# 语言的所有模板
dotnet new we --search --language "F#"
Arguments
TEMPLATE_NAME如果指定了参数,则仅显示模板
<TEMPLATE_NAME>名称或短名称中包含的模板。 如果未指定 、--author、--language--package或--tag选项,则参数是必需的--type。注释
从 .NET SDK 6.0.100 开始,可以将参数放在
<TEMPLATE_NAME>选项后面--search。 例如,dotnet new --search web提供与 ..相同的结果dotnet new web --search。 不允许使用多个参数。
选项
--author <AUTHOR>基于模板作者筛选模板。 支持部分匹配。
--columns <COLUMNS>要在输出中显示的列列表。 支持的列包括:
-
author- 模板作者。 -
language- 模板语言。 -
tags- 模板标记列表。 -
type- 模板类型。
模板名称、短名称、包名称、指示是否为受信任的源,并且始终显示总下载计数。 列的默认列表是模板名称、短名称、语言、包、指示是否为受信任的源和总下载。 若要指定多个列,请多次使用
--columns该选项。-
--columns-all显示输出中的所有列。
-d|--diagnostics启用诊断输出。 自 .NET SDK 7.0.100 起可用。
-
-?|-h|--help打印出有关如何使用命令的说明。
-lang|--language <language>根据模板支持的语言筛选模板。 接受的语言因模板而异,可能的语言为 C#、F#、VB、SQL、JSON、TypeScript 等。 对于某些模板无效。
注释
某些 shell 将
#解释为特殊字符。 在这些情况下,请将语言参数值括在引号中。 例如,dotnet new --search --language "F#"。--package <PACKAGE>基于 NuGet 包 ID 筛选模板。 支持部分匹配。
--tag <TAG>基于模板标记筛选模板。 若要选择,模板必须至少有一个与条件完全匹配的标记。
--type <TYPE>基于模板类型筛选模板。 预定义的值是
project,item和solution。-v|--verbosity <LEVEL>设置命令的详细级别。 允许的值为
q[uiet]、m[inimal]、n[ormal]和diag[nostic]。 自 .NET SDK 7.0.100 起可用。
注释
若要确保模板包出现在结果中 dotnet new --search , 请将 NuGet 包类型 设置为 Template。
例子
搜索 NuGet.org 与 spa 子字符串匹配的所有模板。
dotnet new search spa搜索 NuGet.org 匹配 我们 子字符串并支持 F# 语言的所有模板。
dotnet new search we --language "F#"搜索项模板。
dotnet new search --type item搜索所有 C# 模板,其中显示了输出中的类型和标记。
dotnet new search --language "C#" --columns "type" --columns "tags"