第64章 cargo logout 命令详解

名称

cargo-logout — 在本地删除已保存的 registry API token

概要

cargo logout [options]

描述

该命令会运行一个 credential provider 来删除已保存的 token。

对于默认的 cargo:token credential provider，凭证存储在 $CARGO_HOME/credentials.toml 中，其中 $CARGO_HOME 默认为用户主目录下的 .cargo 目录。

如果某个 registry 指定了 credential provider，则使用该 provider。否则，会按配置项 registry.global-credential-providers 中的 provider 列表，从列表末尾开始依次尝试。

如果未指定 --registry，则会删除默认 registry 的凭证（由 registry.default 配置，默认为 https://crates.io/）。

此命令不会在服务器端撤销 token。如需撤销 token，请访问对应 registry 的网站并按其说明操作（撤销 https://crates.io/ 的 token 请参见 https://crates.io/me）。

选项

Logout 选项

--registry registry

要使用的 registry 名称。registry 名称定义在 Cargo 配置文件中。如未指定，则使用默认 registry，由 registry.default 配置项定义，默认为 crates-io。

显示选项

-v

--verbose

使用详细输出。指定两次可获得“非常详细”的输出，其中包含额外信息，如依赖警告和构建脚本输出。也可以通过 term.verbose 配置项设置。

-q

--quiet

不打印 cargo 日志信息。 也可通过 term.quiet 配置项设置（见配置值）。

--color when

控制彩色输出的使用时机。有效值如下：

• auto（默认值）：自动检测终端是否支持彩色。
• always：始终显示彩色。
• never：从不显示彩色。

也可通过 term.color 配置项设置（见配置值）。

通用选项

+toolchain

如果 Cargo 是通过 rustup 安装的，且 cargo 的第一个参数以 + 开头，它将被视为 rustup 工具链名称（如 +stable 或 +nightly）。 有关工具链覆盖机制的详细信息，请参阅rustup 文档。

--config KEY=VALUE 或 PATH

覆盖 Cargo 配置值。参数需符合 TOML 语法的 KEY=VALUE 格式，或指定为额外配置文件的路径。此标志可指定多次。 更多详情请参阅命令行覆盖章节。

-C PATH

在执行指定操作前更改当前工作目录。这会影响 Cargo 默认查找项目清单文件（Cargo.toml）的位置，以及搜索 .cargo/config.toml 的目录范围等。该选项必须位于命令名称之前，例如 cargo -C path/to/my-project build。

此选项仅在 nightly 通道 上可用， 且需要启用 -Z unstable-options 标志（参见 #10098）。

-h

--help

打印帮助信息。

-Z flag

Cargo 的不稳定（仅限 nightly）标志。运行 cargo -Z help 以获取详细信息。

环境变量

有关 Cargo 读取的环境变量的详细信息，请参阅参考文档。

退出状态

• 0：Cargo 成功。
• 101：Cargo 失败完成。

示例

1. 移除默认 registry 的 token：

   cargo logout
   

2. 移除特定 registry 的 token：

   cargo logout --registry my-registry
   

参见

cargo(1), cargo-login(1)