cargo-login(1)
名称
cargo-login — 登录到注册表
概要
cargo login [选项] [-- 参数]
描述
此命令将运行凭据提供程序以保存令牌,以便需要身份验证的命令(例如 cargo-publish(1))将自动进行身份验证。
跟随双破折号 (--) 的所有参数都将传递给凭据提供程序。
对于默认的 cargo:token 凭据提供程序,令牌保存在 $CARGO_HOME/credentials.toml 中。CARGO_HOME 默认指向您的主目录下的 .cargo。
如果为注册表指定了凭据提供程序,则将使用它。否则,将尝试使用来自配置值 registry.global-credential-providers 的提供程序,从列表末尾开始。
令牌将从标准输入读取。
crates.io 的 API 令牌可以从 https://crates.io/me 获取。
请注意保密令牌,不要与任何人共享。
选项
登录选项
--registry注册表- 要使用的注册表名称。注册表名称在 Cargo 配置文件 中定义。如果未指定,则使用默认注册表,它由
registry.default配置键定义,默认为crates-io。
显示选项
-v--verbose- 使用详细输出。可指定两次以获得“非常详细”的输出,其中包括额外的输出,如依赖警告和构建脚本输出。也可以通过
term.verbose配置值 指定。 -q--quiet- 不打印 cargo 日志消息。也可以通过
term.quiet配置值 指定。 --color何时- 控制何时使用彩色输出。有效值包括:
auto(默认): 自动检测终端是否支持彩色输出。always: 始终显示彩色输出。never: 从不显示彩色输出。
也可以通过
term.color配置值 指定。
通用选项
+工具链- 如果 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查看详细信息。
环境变量
有关 Cargo 读取的环境变量的详细信息,请参见参考。
退出状态
0: Cargo 成功。101: Cargo 未能完成。
示例
-
保存默认注册表的令牌
cargo login -
保存特定注册表的令牌
cargo login --registry my-registry