cargo-verify-project(1)
名称
cargo-verify-project — 检查包清单的正确性
概要
cargo verify-project [选项]
描述
此命令将解析本地清单并检查其有效性。它会发出一个包含结果的 JSON 对象。成功的验证将显示
{"success":"true"}
无效的工作空间将显示
{"invalid":"human-readable error message"}
选项
显示选项
-v--verbose- 使用详细输出。可以指定两次以获得“非常详细”的输出，其中包括额外的输出，例如依赖项警告和构建脚本输出。也可以使用
term.verbose配置值 指定。 -q--quiet- 不打印 cargo 日志消息。也可以使用
term.quiet配置值 指定。 --color何时- 控制何时使用彩色输出。有效值
auto（默认）：自动检测终端上是否支持彩色。always：始终显示颜色。never：从不显示颜色。
也可以使用
term.color配置值 指定。
清单选项
--manifest-path路径Cargo.toml文件的路径。默认情况下，Cargo 在当前目录或任何父目录中搜索Cargo.toml文件。--locked- 断言使用的依赖项和版本与最初生成现有
Cargo.lock文件时完全相同。在出现以下任一情况时，Cargo 将退出并报错- 缺少锁文件。
- 由于不同的依赖项解析，Cargo 尝试更改锁文件。
它可以在需要确定性构建的环境中使用，例如在 CI 管道中。
--offline- 阻止 Cargo 出于任何原因访问网络。如果没有此标志，Cargo 在需要访问网络而网络不可用时将停止并报错。使用此标志，Cargo 将尝试在可能的情况下在没有网络的情况下继续进行。
请注意，这可能会导致与在线模式不同的依赖项解析。Cargo 将限制自己使用本地下载的包，即使索引的本地副本中指示可能有更新的版本。请参阅 cargo-fetch(1) 命令以下载依赖项，然后再脱机。
也可以使用
net.offline配置值 指定。 --frozen- 等效于同时指定
--locked和--offline。
通用选项
+工具链- 如果 Cargo 是使用 rustup 安装的，并且
cargo的第一个参数以+开头，则它将被解释为 rustup 工具链名称（例如+stable或+nightly）。有关工具链覆盖如何工作的更多信息，请参阅 rustup 文档。 --config键=值 或 路径- 覆盖 Cargo 配置值。参数应采用
键=值的 TOML 语法，或作为额外配置文件的路径提供。此标志可以指定多次。有关更多信息，请参阅 命令行覆盖部分。 -C路径- 在执行任何指定的操作之前更改当前工作目录。例如，这会影响 cargo 默认查找项目清单 (
Cargo.toml) 的位置，以及搜索.cargo/config.toml的目录。此选项必须出现在命令名称之前，例如cargo -C path/to/my-project build。此选项仅在 夜间版通道 上可用，并且需要
-Z unstable-options标志才能启用（请参阅 #10098）。 -h--help- 打印帮助信息。
-Z标志- Cargo 的不稳定（仅限夜间版）标志。运行
cargo -Z help以获取详细信息。
环境
有关 Cargo 读取的环境变量的详细信息，请参阅参考。
退出状态
0：工作空间正常。1：工作空间无效。
示例
-
检查当前工作空间是否有错误
cargo verify-project