cargo-logout(1)

名称

cargo-logout — 从本地注册表中移除 API 令牌

概要

cargo logout [选项]

描述

此命令将运行一个凭据提供者来移除保存的令牌。

对于默认的 cargo:token 凭据提供者,凭据存储在 $CARGO_HOME/credentials.toml 文件中,其中 $CARGO_HOME 默认为用户主目录下的 .cargo 目录。

如果注册表指定了凭据提供者,则使用该提供者。否则,将尝试使用配置值 registry.global-credential-providers 中的提供者,从列表末尾开始尝试。

如果未指定 --registry,则将移除默认注册表的凭据(通过 registry.default 配置,默认为 https://crates.io/)。

这不会撤销服务器上的令牌。如果您需要撤销令牌,请访问注册表网站并按照其说明操作(例如访问 https://crates.io/me 以撤销 https://crates.io/ 的令牌)。

选项

注销选项

--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

此选项仅在每夜构建通道上可用,并且需要 -Z unstable-options 标志才能启用(参见 #10098)。

-h
--help
打印帮助信息。
-Z 标志
Cargo 的不稳定(仅限每夜构建)标志。运行 cargo -Z help 查看详细信息。

环境

有关 Cargo 读取的环境变量的详细信息,请参见参考

退出状态

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

示例

  1. 移除默认注册表的令牌

    cargo logout
    
  2. 移除特定注册表的令牌

    cargo logout --registry my-registry
    

另请参见

cargo(1), cargo-login(1)