第61章 cargo search 命令详解

名称

cargo-search — 在注册表中搜索软件包。默认注册表为 crates.io

概要

cargo search [选项] [查询词…]

描述

该命令在 https://crates.io 上执行文本搜索以查找 crate。匹配到的 crate 及其描述将以 TOML 格式显示，方便直接复制到 Cargo.toml 清单文件中。

选项

搜索选项

--limit limit

限制结果数量（默认：10，最大：100）。

--index index

要使用的注册表索引 URL。

--registry registry

要使用的注册表名称。注册表名称在 Cargo 配置文件 中定义。如果未指定，则使用默认注册表，其值由配置项 registry.default 决定，默认为 crates-io。

显示选项

-v

--verbose

使用详细输出。可指定两次以获取“非常详细”的输出，包括依赖警告和构建脚本输出等额外信息。也可通过 term.verbose 配置值 进行指定。

-q

--quiet

不打印 Cargo 日志信息。 也可以通过 term.quiet 配置项 指定。

--color when

控制何时使用彩色输出。可选值：

• auto（默认）：自动检测终端是否支持彩色显示。
• always：始终显示彩色。
• never：从不显示彩色。

也可以通过 term.color 配置项 指定。

通用选项

+toolchain

如果 Cargo 是通过 rustup 安装的，且 cargo 的第一个参数以 + 开头，则会被视为 rustup 工具链名称（例如 +stable 或 +nightly）。 关于工具链覆盖的工作原理，详见 rustup 文档。

--config KEY=VALUE 或 PATH

覆盖 Cargo 的配置值。参数应为 KEY=VALUE 形式的 TOML 语法，或提供一个额外配置文件的路径。此参数可以多次指定。 详见命令行覆盖一节。

-C PATH

在执行指定操作前更改当前工作目录。这会影响默认查找项目清单（Cargo.toml）的位置，以及用于发现 .cargo/config.toml 的搜索目录等。该选项必须位于命令名之前，例如 cargo -C path/to/my-project build。

此选项仅在 nightly 通道 上可用， 且需要启用 -Z unstable-options 标志（参见 #10098）。

-h

--help

打印帮助信息。

-Z flag

Cargo 的非稳定（仅限 nightly）标志。运行 cargo -Z help 以获取详细信息。

环境变量

关于 Cargo 读取的环境变量的详细信息，请参阅 参考文档。

退出状态

• 0：Cargo 执行成功。
• 101：Cargo 执行失败。

示例

1. 在 crates.io 中搜索软件包：

   cargo search serde
   

另请参阅

cargo(1)、cargo-install(1)、cargo-publish(1)