cargo-generate-lockfile(1)
名称
cargo-generate-lockfile — 为包生成锁定文件
概要
cargo generate-lockfile [选项]
描述
此命令将为当前包或工作空间创建 Cargo.lock 锁定文件。如果锁定文件已存在，它将使用每个包的最新可用版本重建。
另请参阅 cargo-update(1)，它也能够创建 Cargo.lock 锁定文件，并且具有更多用于控制更新行为的选项。
选项
显示选项
-v--verbose- 使用详细输出。可以指定两次以获得“非常详细”的输出，其中包括额外的输出，例如依赖项警告和构建脚本输出。也可以使用
term.verbose配置值 指定。 -q--quiet- 不打印 cargo 日志消息。也可以使用
term.quiet配置值 指定。 --color何时- 控制何时使用彩色输出。有效值：
auto（默认）：自动检测终端上是否支持彩色。always：始终显示颜色。never：从不显示颜色。
也可以使用
term.color配置值 指定。
清单选项
--manifest-path路径Cargo.toml文件的路径。默认情况下，Cargo 在当前目录或任何父目录中搜索Cargo.toml文件。--ignore-rust-version- 忽略包中的
rust-version规范。 --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：Cargo 成功。101：Cargo 未能完成。
示例
-
为当前包或工作空间创建或更新锁定文件
cargo generate-lockfile