cargo-uninstall(1)

名称

cargo-uninstall - 移除一个 Rust 二进制程序

概要

cargo uninstall [options] [spec...]

描述

这个命令会移除一个用 cargo-install(1) 安装的包。 spec 参数是被移除的包的 package ID specification (见 cargo-pkgid(1) )。

默认会移除该 crate 的所有可执行程序，但可以用 --bin 和 --example 标志来移除指定的二进制程序。

安装根目录位置按以下的优先级进行检测:

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

选项

安装选项

-p

--package spec...

要卸载的包。

--bin name...

只卸载名为 name 的二进制程序。

--root dir

从哪个文件夹中移除该包。

显示选项

-v

--verbose

进行 verbose 输出。可以指定两遍来开启 "very verbose" 模式，输出更多的额外信息，像是依赖项的警告和构建脚本的输出信息。 也可以通过 term.verbose 配置选项 来指定。

-q

--quiet

不打印 cargo log 信息。 也可以通过 term.quiet 配置。

--color when

控制*何时*使用彩色输出。可选值有:

• auto (默认值): 自动检测终端是否支持彩色输出。
• always: 总是显示彩色。
• never: 从不显示彩色。

也可以在 term.color 配置。

通用选项

+toolchain

如果 Cargo 由 rustup 安装，那么 cargo 后第一个以 + 开头的参数会被认为是 rustup toolchain 名字(例如 +stable 或 +nightly)。 查看 rustup documentation 了解 toolchain overrides 如何工作。

--config KEY=VALUE or PATH

覆盖一个 Cargo 配置的值。参数应该是一个 TOML 语法的 KEY=VALUE，或者提供一个路径来指向一个额外的配置文件 (configuration file)。 这个标记可以指定多次。 参考 command-line overrides 一节 获取更多信息。

-h

--help

打印帮助信息。

-Z flag

不稳定 (nightly-only) 的标志。 执行 cargo -Z help 获取详细信息。

环境

查看 the reference 获取 Cargo 读取的环境变量的更多信息。

退出状态

• 0: Cargo 执行成功。
• 101: Cargo 没有执行完成。

使用案例

1. 卸载一个之前安装的包:

   cargo uninstall ripgrep
   

其他参考

cargo(1), cargo-install(1)