cargo-login(1)

名称

cargo-login - 将 registry 的 API token 保存到本地

概要

cargo login [options] [token]

描述

这个命令会将一个 API token 保存到本地磁盘，之后那些需要身份验证的命令 (比如 cargo-publish(1)) 就会自动验证了。这个 token 保存在 $CARGO_HOME/credentials.toml。CARGO_HOME 默认为你 home 目录的 .cargo 文件夹。

如果没有带上 token 参数，则会从 stdin 中读取。

crates.io 的 API token 可以从 https://crates.io/me 获取。

注意保护你的 token，不要将其泄露给他人。

选项

登陆选项

--registry registry
使用的 registry 的名字。 Registry 的名字定义在 Cargo 配置文件中。 如果没有指定，则使用默认的 registry， 其定义于 registry.default 配置选项中，其默认值为 crates-io 。

显示选项

-v
--verbose
进行 verbose 输出。可以指定两遍来开启 "very verbose" 模式，输出更多的额外信息，像是依赖项的警告和构建脚本的输出信息。 也可以通过 term.verbose 配置选项 来指定。
-q
--quiet
不打印 cargo log 信息。 也可以通过 term.quiet 配置选项来指定。
--color when
控制*何时*使用彩色输出。可选值有:

  • auto (默认值): 自动检测终端是否支持彩色输出。
  • always: 总是显示彩色。
  • never: 从不显示彩色。

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

通用选项

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

退出状态

  • 0: Cargo 执行成功。
  • 101: Cargo 没有执行完成。

使用案例

  1. 将 API token 保存到本地磁盘:

    cargo login

其他参考

cargo(1), cargo-publish(1)