cargo-fetch(1)

名称 (NAME)

cargo-fetch — 从网络拉取软件包的依赖项

概要 (SYNOPSIS)

cargo fetch [选项]

描述 (DESCRIPTION)

如果存在 `Cargo.lock` 文件，此命令将确保所有 Git 依赖项和/或注册表依赖项都已下载并在本地可用。除非 lock 文件发生变化，否则在运行 `cargo fetch` 后，后续的 Cargo 命令将能够离线运行。

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

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

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

选项 (OPTIONS)

拉取选项

--target 三元组
为给定的架构拉取依赖项。默认是所有架构。三元组的一般格式是 <arch><sub>-<vendor>-<sys>-<abi>。运行 rustc --print target-list 查看支持的目标列表。该标志可以指定多次。

也可以通过 build.target 配置值指定。

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

显示选项

-v
--verbose
使用详细输出。可以指定两次以获得“非常详细”的输出，其中包括额外的输出，例如依赖警告和构建脚本输出。也可以通过 term.verbose 配置值指定。
-q
--quiet
不打印 cargo 日志消息。也可以通过 term.quiet 配置值指定。
--color 何时
控制何时使用彩色输出。有效值：

  • 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 路径
更改 lock 文件的路径，使其不是默认路径 (`<workspace_root>/Cargo.lock`)，而是改为 路径。路径 必须以 Cargo.lock 结尾（例如 --lockfile-path /tmp/temporary-lockfile/Cargo.lock）。请注意，提供 --lockfile-path 会忽略默认路径下存在的 lock 文件，转而使用 路径 中的 lock 文件，如果 路径 不存在 lock 文件，则将新的 lock 文件写入提供的 路径。此标志可用于在只读目录中运行大多数命令，将 lock 文件写入提供的 路径。

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

通用选项

+工具链
如果 Cargo 是通过 rustup 安装的，并且 `cargo` 的第一个参数以 `+` 开头，它将被解释为一个 rustup 工具链名称（例如 `+stable` 或 `+nightly`）。有关工具链覆盖机制如何工作的更多信息，请参阅 rustup 文档。
--config 键=值 或 路径
覆盖 Cargo 配置值。参数应采用 键=值 的 TOML 语法，或提供一个额外的配置文件路径。该标志可以指定多次。有关更多信息，请参阅命令行覆盖章节。
-C 路径
在执行任何指定操作之前更改当前工作目录。这会影响 Cargo 默认在哪里查找项目清单 (`Cargo.toml`) 等，以及搜索 `.cargo/config.toml` 的目录，例如。此选项必须出现在命令名称之前，例如 cargo -C path/to/my-project build。

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

-h
--help
打印帮助信息。
-Z 标志
Cargo 的不稳定（仅限 nightly）标志。运行 cargo -Z help 查看详情。

环境变量 (ENVIRONMENT)

有关 Cargo 读取的环境变量的详细信息，请参阅参考手册。

退出状态 (EXIT STATUS)

  • 0: Cargo 成功完成。
  • 101: Cargo 未能完成。

示例 (EXAMPLES)

  1. 拉取所有依赖项

    cargo fetch

另请参阅 (SEE ALSO)

cargo(1), cargo-update(1), cargo-generate-lockfile(1)