cargo-fetch(1)

描述

如果存在 Cargo.lock 文件，此命令将确保所有 git 依赖项和/或 registry 依赖项都已下载并在本地可用。在执行 cargo fetch 之后，除非 lock 文件发生更改，否则后续的 Cargo 命令将能够离线运行。

如果 lock 文件不可用，则此命令将在获取依赖项之前生成 lock 文件。

如果未指定 --target，则会获取所有目标依赖项。

另请参阅 cargo-prefetch 插件，该插件添加了一个用于下载常用 crate 的命令。如果您计划在没有网络的情况下使用带有 --offline 标志的 Cargo，这可能会很有用。

选项

获取选项

--target 三元组

为给定的架构获取。默认值是所有架构。三元组的通用格式是 <arch><sub>-<vendor>-<sys>-<abi>。运行 rustc --print target-list 获取支持的目标列表。此标志可以多次指定。

也可以使用 build.target 配置值指定。

请注意，指定此标志会使 Cargo 在不同的模式下运行，其中目标工件放置在单独的目录中。有关更多详细信息，请参阅构建缓存文档。

显示选项

-v

--verbose

使用详细输出。可以指定两次以获得“非常详细”的输出，其中包括额外的输出，例如依赖项警告和构建脚本输出。也可以使用 term.verbose 配置值指定。

-q

--quiet

不打印 cargo 日志消息。也可以使用 term.quiet 配置值指定。

--color when

控制何时使用彩色输出。有效值：

auto（默认值）：自动检测终端上是否支持颜色。
always：始终显示颜色。
never：从不显示颜色。

也可以使用 term.color 配置值指定。

清单选项

--manifest-path 路径

Cargo.toml 文件的路径。默认情况下，Cargo 会在当前目录或任何父目录中搜索 Cargo.toml 文件。

--locked

断言使用的依赖项和版本与最初生成现有 Cargo.lock 文件时完全相同。当出现以下任何一种情况时，Cargo 将以错误退出：

lock 文件丢失。
Cargo 由于不同的依赖项解析而尝试更改 lock 文件。

它可以用在需要确定性构建的环境中，例如 CI 管道中。

--offline

阻止 Cargo 以任何理由访问网络。如果没有此标志，如果 Cargo 需要访问网络且网络不可用，则会停止并显示错误。使用此标志，如果可能，Cargo 将尝试在没有网络的情况下继续。

请注意，这可能会导致与在线模式不同的依赖项解析。Cargo 将把自己限制在本地下载的 crate 上，即使本地索引副本中可能指示有较新的版本。

也可以使用 net.offline 配置值指定。

--frozen

等效于同时指定 --locked 和 --offline。

--lockfile-path 路径

将 lockfile 的路径从默认值（<workspace_root>/Cargo.lock）更改为 PATH。PATH 必须以 Cargo.lock 结尾（例如 --lockfile-path /tmp/temporary-lockfile/Cargo.lock）。请注意，提供 --lockfile-path 将忽略默认路径下的现有 lockfile，而是使用 PATH 中的 lockfile，或者如果它不存在，则将新的 lockfile 写入提供的 PATH。此标志可用于在只读目录中运行大多数命令，并将 lockfile 写入提供的 PATH。

此选项仅在 nightly channel 上可用，并且需要 -Z unstable-options 标志来启用（请参阅 #14421）。