cargo-fetch(1)

名称

cargo-fetch - 从网络中下载一个包的依赖。

cargo fetch [options]

如果有一个可用的 Cargo.lock ，则该命令可以保证所有的 git 依赖和/或 registry 依赖都会被下载且本地可用。cargo fetch 之后的命令都可以离线 (offline) 执行，除非 lock file 发生改变。

如果 lock file 不可用，则该命令会在下载依赖之前生成 lock file。

如果没有指定 --target ，则所有 target 的依赖都会被下载。

另见 cargo-prefetch 插件，其可以添加一个命令来下载流行的 crates。如果你打算在无网络的环境使用 Cargo (使用 --offline)，那么这个命令可能会很有用。

--target triple

为指定的架构而下载依赖，默认为所有架构下载。triple 的格式为 <arch><sub>-<vendor>-<sys>-<abi>。执行 rustc --print target-list 可以展示支持的 target 的列表。该标志可以指定多次。

也可以通过 build.target 配置。

注意，指定这个标志会使Cargo在不同的模式下运行，目标制品放在单独目录。参见构建缓存文档了解详情。

-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 读取的环境变量的更多信息。