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
: 工作空间失效。
示例
-
检查当前工作空间错误:
cargo verify-project