dotnet 包搜索

本文适用于： ✔️.NET 8.0.2xx SDK 及更高版本

名称

dotnet package search - 搜索 NuGet 包。

摘要

dotnet package search <SEARCH TERM> [--configfile <FILE>] [--exact-match] [--format <FORMAT OPTION>]
    [--interactive] [--prerelease] [--skip <NUMBER>] [--source <SOURCE>] [--take <NUMBER>]
    [--verbosity <VERBOSITY VALUE>]

dotnet package search -h|--help

说明

该 dotnet package search 命令搜索 NuGet 包。

参数

• search terms

  指定要筛选结果的搜索词。 使用此参数搜索与提供的查询匹配的包。 示例：dotnet package search json。

选项

• --configfile

  NuGet 配置文件。 如果指定，则只使用此文件中的设置。 如果不指定，将使用当前目录中的配置文件的层次结构。 有关详细信息，请参阅常见的 NuGet 配置。

• --exact-match

  此选项将搜索范围缩小为仅包含 ID 与指定搜索词完全匹配的包，从而有效地筛选掉任何部分匹配项。 它提供标识包的所有可用版本的简明列表。 原因 --take 和 --skip 选项将被忽略。 使用此选项可显示指定包的所有可用版本。

• --format

  格式选项和 tablejson。 默认为 table。

• --interactive

  允许命令停止并等待用户输入或操作（例如，完成身份验证）。

• --prerelease

  允许显示预发行版包。

• --skip

  要跳过的结果数，用于分页。 默认值为 0。

• --source <SOURCE>

  要搜索的包源。 可以传递多个 --source 选项来搜索多个包源。

• --take

  要返回的结果数量。 默认值为 20。

• --verbosity

  在输出中显示此详细信息量： normal， minimal或 detailed。 默认为 normal。

• -?|-h|--help

  打印出有关如何使用命令的说明。

示例

• 搜索 NuGet.org 与搜索词“Newtonsoft.Json”匹配的包，并将输出呈现为包含最多 20 个包的表：

  dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json
  

      Source: https://api.nuget.org/v3/index.json
      | Package ID                                  | Latest Version | Owners | Downloads       |
      |---------------------------------------------|----------------|--------|-----------------|
      | Newtonsoft.Json                             | 13.0.3         |        | 3,829,822,911   |
      |---------------------------------------------|----------------|--------|-----------------|
      | Newtonsoft.Json.Bson                        | 1.0.2          |        | 554,641,545     |
      |---------------------------------------------|----------------|--------|-----------------|
      | Newtonsoft.Json.Schema                      | 3.0.15         |        | 39,648,430      |
      |---------------------------------------------|----------------|--------|-----------------|
      | Microsoft.AspNetCore.Mvc.NewtonsoftJson     | 7.0.12         |        | 317,067,823     |
      |---------------------------------------------|----------------|--------|-----------------|
      ...
  

• 搜索与搜索词“Newtonsoft.Json”匹配的包 NuGet.org，并将输出呈现为 json。

  dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json --format json
  

      {
      "version": 2,
      "problems": [],
      "searchResult": [
          {
          "sourceName": "https://api.nuget.org/v3/index.json",
          "packages": [
              {
              "id": "Newtonsoft.Json",
              "latestVersion": "13.0.3",
              "totalDownloads": 4456137550,
              "owners": "dotnetfoundation, jamesnk, newtonsoft"
              },
              {
              "id": "Newtonsoft.Json.Bson",
              "latestVersion": "1.0.2",
              "totalDownloads": 655362732,
              "owners": "dotnetfoundation, jamesnk, newtonsoft"
              },
              {
              "id": "Newtonsoft.Json.Schema",
              "latestVersion": "3.0.15",
              "totalDownloads": 46062119,
              "owners": "jamesnk, newtonsoft"
              },
              {
              "id": "Microsoft.AspNetCore.Mvc.NewtonsoftJson",
              "latestVersion": "8.0.3",
              "totalDownloads": 372202749,
              "owners": "aspnet, dotnetframework, Microsoft"
              },
              {
              "id": "Newtonsoft.Json.Encryption",
              "latestVersion": "2.2.0",
              "totalDownloads": 113101,
              "owners": "simoncropp"
              }
          ]
          }
      ]
      }
  

• 使用搜索词“Newtonsoft.Json”搜索包 NuGet.org，只显示两个结果，并跳过搜索结果中的第一个包：

  dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json --skip 1 --take 2
  

      Source: https://api.nuget.org/v3/index.json
      | Package ID                                  | Latest Version | Owners | Downloads       |
      |---------------------------------------------|----------------|--------|-----------------|
      | Newtonsoft.Json.Bson                        | 1.0.2          |        | 554,641,545     |
      | Newtonsoft.Json.Schema                      | 3.0.15         |        | 39,648,430      |
  

• 搜索与“Newtonsoft.Json”完全匹配的包并列出其所有可用版本，忽略任何包含“Newtonsoft.Json”的包作为其名称或说明的一部分，但不完全匹配它：

  dotnet package search Newtonsoft.Json --source https://api.nuget.org/v3/index.json --exact-match
  

      Source: https://api.nuget.org/v3/index.json
      | Package ID                                  | Version | Owners | Downloads       |
      |---------------------------------------------|---------|--------|-----------------|
      | Newtonsoft.Json                             | 13.0.3  |        | 3,829,822,911   |