cargo-generate-lockfile(1)

名称

cargo-generate-lockfile - 为一个包生成 lockfile

cargo generate-lockfile [options]

这个命令会为当前的包 (package) 或工作空间 (workspace) 生成 Cargo.lock。如果 lockfile 已经存在，则会用各包的最新可用版本重新生成 Cargo.lock 。

另见 cargo-update(1) ，其也可以生成 Cargo.lock ，而且有更多针对更新策略的设置选项。

-v

--verbose

进行 verbose 输出。可以指定两遍来开启 "very verbose" 模式，输出更多的额外信息，像是依赖项的警告和构建脚本的输出信息。也可以通过 term.verbose 配置选项来指定。

-q

--quiet

不打印 cargo log 信息。也可以通过 term.quiet 配置选项来指定。

--color when

控制*何时*使用彩色输出。可选值有:

也可以在 term.color 配置选项中设置。

--manifest-path path

Cargo.toml 文件的路径。默认情况下，Cargo 会从当前目录或任意的上级目录搜索 Cargo.toml 。

--frozen

--locked

这两个 flag 都需要 Cargo.lock 文件处于无需更新的状态。如果 lock 文件缺失，或者需要被更新，Cargo 会报错退出。 --frozen flag 还会阻止 Cargo 访问网络来判断 Cargo.lock 是否过期。

这些 flag 可以用于某些场景下你想断言 Cargo.lock 无需更新 (比如在CI中构建) 或者避免网络访问。

--offline

阻止 Cargo 访问网络。如果没有这个 flag，当 Cargo 需要访问网络但是没有网络时，就会报错退出。加上这个 flag，Cargo 会尝试在不联网的情况下继续执行 (如果可以的话) 。

要小心这会导致与在线模式不同的解析结果。Cargo 会限制自己在本地已下载的 crate 中查找版本，即使在本地的 index 拷贝中表明还有更新的版本。 cargo-fetch(1) 命令可以在进入离线模式前下载依赖。

同样的功能也可以通过设置 net.offline 配置选项来实现。

+toolchain: 如果 Cargo 由 rustup 安装，那么 cargo 后第一个以 + 开头的参数会被认为是 rustup toolchain 名字(例如 +stable 或 +nightly)。查看 rustup documentation 了解 toolchain overrides 如何工作。
--config KEY=VALUE or PATH: 覆盖一个 Cargo 配置的值。参数应该是一个 TOML 语法的 KEY=VALUE，或者提供一个路径来指向一个额外的配置文件 (configuration file)。这个标记可以指定多次。参考 command-line overrides 一节获取更多信息。
-h
--help: 打印帮助信息。
-Z flag: 不稳定 (nightly-only) 的标志。执行 cargo -Z help 获取详细信息。

查看 the reference 获取 Cargo 读取的环境变量的更多信息。

创建或更新当前包 (package) 或工作空间 (workspace) 的 lockfile:
```
cargo generate-lockfile
```