第69章 cargo report 命令详解

名称

cargo-report — 生成并显示各类报告

概要

cargo report 类型 [选项]

描述

显示指定类型的报告，目前仅支持 future-incompat。

选项

显示选项

-v

--verbose

启用详细输出。可指定两次以获得“极详细”输出，其中包含依赖项警告和构建脚本输出等额外信息。 也可通过 term.verbose 配置项 指定。

-q

--quiet

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

--color when

控制彩色输出的使用场景。有效值：

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

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

清单选项

--locked

断言依赖及其版本与现有 Cargo.lock 文件生成时完全一致。出现以下任一情况时，Cargo 将报错退出：

• 锁文件不存在。
• Cargo 因依赖解析结果不同而试图修改锁文件。

适用于需要确定性构建的环境，比如 CI 流水线。

--offline

禁止 Cargo 以任何理由访问网络。如果不加此标志，当 Cargo 需要访问网络而网络不可用时，会直接报错停止；加上此标志后，Cargo 会尽可能在无网络的情况下继续运行。

注意，这可能导致依赖解析结果与联网模式不同。Cargo 只会使用已下载到本地的 crate，即使本地索引副本中显示有更新的版本。可先用 cargo-fetch(1) 命令下载好依赖，再进入离线状态。

也可以通过 config 值 net.offline 来指定。

--frozen

等价于同时指定 --locked 和 --offline。

通用选项

+toolchain

如果 Cargo 是通过 rustup 安装的，且 cargo 的第一个参数以 + 开头，它会被解析为 rustup 工具链名称（如 +stable 或 +nightly）。有关工具链覆盖机制的更多信息，参见 rustup 文档。

--config KEY=VALUE or PATH

覆盖 Cargo 配置项。参数需采用 KEY=VALUE 格式的 TOML 语法，或指定为额外配置文件的存储路径。该标志可多次指定。详细信息请参阅命令行覆盖章节。

-C PATH

在执行指定操作前更改当前工作目录。这将影响 Cargo 查找项目清单（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 查看详细信息。

ENVIRONMENT

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

EXIT STATUS

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

EXAMPLES

1. 显示可用的报告类型：

   cargo report --help
   

参见

cargo(1)，cargo-report-future-incompatibilities(1)