cargo-search(1)

名称

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

概要

cargo search [选项] [查询…]

描述

这会在 https://crates.io 上执行对 crate 的文本搜索。匹配的 crate 将会以 TOML 格式显示，并带有其描述，适合复制到 Cargo.toml 清单中。

选项

搜索选项

--limit 限制
限制结果的数量（默认：10，最大：100）。
--index 索引
要使用的注册表索引的 URL。
--registry 注册表
要使用的注册表的名称。注册表名称在 Cargo 配置文件中定义。如果未指定，则使用默认注册表，该默认注册表由 registry.default 配置键定义，默认为 crates-io。

显示选项

-v
--verbose
使用详细输出。可以指定两次以获得“非常详细”的输出，其中包括额外的输出，例如依赖警告和构建脚本输出。也可以使用 term.verbose 配置值来指定。
-q
--quiet
不打印 Cargo 日志消息。也可以使用 term.quiet 配置值来指定。
--color 何时
控制何时使用彩色输出。有效值：

  • auto (默认): 自动检测终端是否支持颜色。
  • always: 始终显示颜色。
  • never: 永不显示颜色。

也可以使用 term.color 配置值来指定。

通用选项

+工具链
如果 Cargo 是使用 rustup 安装的，并且 cargo 的第一个参数以 + 开头，则它将被解释为 rustup 工具链名称（例如 +stable 或 +nightly）。有关工具链覆盖如何工作的更多信息，请参阅 rustup 文档。
--config KEY=VALUE 或 PATH
覆盖 Cargo 配置值。参数应为 KEY=VALUE 的 TOML 语法，或提供为额外的配置文件路径。可以多次指定此标志。有关更多信息，请参阅 命令行覆盖部分。
-C 路径
在执行任何指定的操作之前更改当前工作目录。这会影响诸如 cargo 默认查找项目清单 (Cargo.toml) 的位置，以及搜索发现 .cargo/config.toml 的目录等。此选项必须出现在命令名称之前，例如 cargo -C path/to/my-project build。

此选项仅在 nightly channel 上可用，并且需要使用 -Z unstable-options 标志启用（请参阅 #10098）。

-h
--help
打印帮助信息。
-Z 标志
Cargo 的不稳定（仅限 nightly）标志。运行 cargo -Z help 以获取详细信息。

环境变量

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

退出状态

  • 0: Cargo 成功。
  • 101: Cargo 未能完成。

示例

  1. 从 crates.io 搜索一个包

    cargo search serde

另请参阅

cargo(1), cargo-install(1), cargo-publish(1)