cargo-search(1)

定义

cargo-search - 在 crates.io 上搜索包

概要

cargo search [options] [query...]

说明

这将对 https://crates.io 上的 crates 进行文本搜索。匹配的 的 crates 将被显示出来，crates 的描述也会以 TOML 格式显示出来，以便复制到 Cargo.toml 中。

选项

搜索选项

--limit limit

限制结果显示数量 (默认: 10, 最大: 100).

--index index

registry 索引使用的地址.

--registry registry

使用的 registry 的名称。 Registry 的名称定义在 Cargo config files。 若此选项未指定，则使用默认 registry， 默认 registry 由 registry.default 定义。它默认为 crates-io。

展示选项

-v

--verbose

使用 verbose 级别输出详细信息。 指定两次此选项来输出 "十分详细" 的输出信息， 这会包含额外的输出信息，比如依赖警告和构建脚本输出。 也可以与 term.verbose config value 一起使用。

-q

--quiet

不要打印任何 cargo 日志信息。 也可以与 term.quiet config value 一起使用。

--color when

控制的日志的颜色。 有效的值如下:

• auto (默认): 自动检测终端颜色支持是否可用。
• always: 总是带颜色显示。
• never: 不带颜色显示.

也可以与 term.color config value 一起使用。

通用选项

+toolchain

如果Cargo已经和rustup一起安装, 并且 cargo 的第一个参数以 + 开头, 它将被解释为一个rustup工具链的名字 (比如 +stable 或者 +nightly)。 更多关于工具链覆盖工作的信息，请参见 rustup documentation

--config KEY=VALUE or PATH

覆盖一个 Cargo 配置值。参数应该使用 TOML 的 KEY=VALUE 语法，或者提供一个额外配置文件的路径。 这个标志可以被多次指定。更多信息请参见 command-line overrides section。

-h

--help

打印帮助信息。

-Z flag

Cargo 的不稳定 (仅限 nightly 版本) 标志。 更多信息请运行 cargo -Z help。

环境

参见the reference 获取关于 Cargo 所读取的环境变量的细节。

额外状态

• 0: Cargo 成功完成某项任务.
• 101: Cargo 未能完成某项任务.

例子

1. 在 crates.io 上搜索一个包: cargo search serde

另请参见

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