dotnet new search

  • 项目

本文适用于：✔️ .NET Core 5.0.300 SDK 及更高版本

名称

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]

说明

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，请使用包含 --check-only 选项的 update 子命令。

之前可用的其他选项仍可用于各自的子命令。 每个子命令的单独帮助可通过 -h 或 --help 选项获得：dotnet new <subcommand> --help 列出子命令的所有支持选项。

此外，tab 自动补全现可供 dotnet new 使用。 它支持安装模板名称的自动补全，以及所选模板所提供选项的自动补全。 若要激活 .NET SDK 的 tab 自动补全，请参阅启用 tab 自动补全。

旧语法的示例：

  • 搜索 NuGet.org 上提供的与“we”子字符串匹配且支持 F# 语言的所有模板

    dotnet new we --search --language "F#"

自变量

  • TEMPLATE_NAME

    如果指定了参数，将只显示模板名称或短名称中包含 <TEMPLATE_NAME> 的模板。 如果未指定 、--language、--tag--package或--type选项，则参数是必需的--author。

    注意

    从 .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

    打印 search 命令帮助。 自 .NET SDK 7.0.100 之后可用。

  • -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 上提供的与 we 子字符串匹配且支持 F# 语言的所有模板。

    dotnet new search we --language "F#"

  • 搜索项模板。

    dotnet new search --type item

  • 搜索所有 C# 模板，并在输出中显示类型和标记。

    dotnet new search --language "C#" --columns "type" --columns "tags"

另请参阅