第62章 Cargo 卸载命令详解：移除 Rust 二进制文件

名称

cargo-uninstall — 移除一个 Rust 二进制文件

概要

cargo uninstall [选项] [spec…]

描述

此命令用于移除通过 cargo-install(1) 安装的包。spec 参数是要移除包的包 ID 规范（参见 cargo-pkgid(1)）。

默认会移除 crate 的所有二进制文件，但可以使用 --bin 和 --example 选项只移除特定的二进制文件。

安装根目录按以下优先级确定：

• --root 选项
• CARGO_INSTALL_ROOT 环境变量
• Cargo 的 install.root 配置项
• CARGO_HOME 环境变量
• $HOME/.cargo

选项

卸载选项

-p

--package spec…

要卸载的包。

--bin name…

只卸载指定的二进制文件 name。

--root dir

卸载包所在的目录。

显示选项

-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 配置值。参数需符合 KEY=VALUE 的 TOML 语法，或指定为额外配置文件的的路径。此标志可多次指定。 更多信息请参阅命令行覆盖章节。

-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. 卸载之前安装的包。

   cargo uninstall ripgrep
   

另见

cargo(1), cargo-install(1)