通过

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   |