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
配置值 指定。
常用选项
+
工具链- 如果使用 rustup 安装了 Cargo,并且
cargo
的第一个参数以+
开头,则它将被解释为 rustup 工具链名称(例如+stable
或+nightly
)。有关工具链覆盖如何工作的更多信息,请参阅 rustup 文档。 --config
键=值 或 路径- 覆盖 Cargo 配置值。参数应采用
键=值
的 TOML 语法,或作为额外配置文件的路径提供。此标志可以指定多次。有关更多信息,请参阅 命令行覆盖部分。 -C
路径- 在执行任何指定的操作之前更改当前工作目录。这会影响 Cargo 默认查找项目清单 (
Cargo.toml
) 的位置,以及搜索.cargo/config.toml
的目录等。此选项必须出现在命令名称之前,例如cargo -C path/to/my-project build
。此选项仅在 夜间版通道 上可用,并且需要
-Z unstable-options
标志才能启用(请参阅 #10098)。 -h
--help
- 打印帮助信息。
-Z
标志- Cargo 的不稳定(仅限夜间版)标志。运行
cargo -Z help
以获取详细信息。
环境
有关 Cargo 读取的环境变量的详细信息,请参阅 参考。
退出状态
0
:Cargo 成功。101
:Cargo 未能完成。
示例
-
保存默认注册表的令牌
cargo login
-
保存特定注册表的令牌
cargo login --registry my-registry