cargo-verify-project(1)

定义

cargo-verify-project - 检查crate配置清单的正确性

概要

cargo verify-project [options]

说明

该命令将解析本地配置清单并检查其有效性。发送包含结果的JSON对象。如果验证成功,将显示:

{"success":"true"}

一个无效的工作空间将显示:

{"invalid":"human-readable error message"}

选项

显示选项

-v
--verbose
进行详细输出。可以指定两次来开启 "非常详细" ,输出更多的额外信息,像是依赖项的警告和构建脚本的输出信息。 也可以通过 term.verbose 配置
-q
--quiet
不打印 cargo 日志信息。 也可以用 term.quiet 配置
--color when
使用彩色输出。有效值:

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

也可以用 term.color 配置

配置选项

--manifest-path path
Cargo.toml 文件的路径。默认, Cargo 在当前目录和任意父目录搜索 Cargo.toml 文件。
--frozen
--locked
这些标志都要求 Cargo.lock 文件是最新的。 如果lock文件丢失, 或是需要更新, Cargo会返回错误并退出,--frozen 选项还会阻止cargo通过网络来判断其是否过期。

可以用于断言 Cargo.lock 文件是否最新状态(例如CI构建)或避免网络访问。

--offline
阻止Cargo访问网络。如果不指定该选项,Cargo会在需要使用网络但不可用时停止构建并返回错误。设置该标识,Cargo将尽可能不使用网络完成构建。

需注意,这样可能会导致与在线模式不同的依赖处理,Cargo将限制仅使用已下载到本地的crate,即使本地索引中有更新版本。 查阅 cargo-fetch(1) 命令,在脱机前下载依赖。

也可以用 net.offline 配置

常规选项

+toolchain
如果Cargo已经通过rustup安装,并且第一个传给 cargo 的参数以 + 开头, 则当作rustup的工具链名称。(例如 +stable+nightly). 查阅 rustup 文档 了解关于工具链覆盖的信息。
--config KEY=VALUE or PATH
覆盖Cargo配置项的值,该参数应当为TOML KEY=VALUE 语法, 或者提供附加的配置文件的路径。该标识可以多次指定。 查阅 命令行覆盖部分 获取更多信息
-h
--help
打印帮助信息。
-Z flag
Cargo不稳定的(每日构建)标志。运行 cargo -Z help 了解详情。

ENVIRONMENT

查阅 参考 了解Cargo读取环境变量。

退出状态

  • 0: 工作空间正常。
  • 1: 工作空间失效。

示例

  1. 检查当前工作空间错误:

    cargo verify-project
    

参阅

cargo(1), cargo-package(1)