cargo-uninstall(1)

名称

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

概要

cargo uninstall [选项] [规范…]

描述

此命令移除使用 cargo-install(1) 安装的包。规范 参数是要移除的包的包 ID 规范(请参阅 cargo-pkgid(1))。

默认情况下,将移除箱子的所有二进制文件,但可以使用 --bin--example 标志仅移除特定的二进制文件。

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

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

选项

安装选项

-p
--package 规范
要卸载的包。
--bin 名称
仅卸载名为 名称 的二进制文件。
--root 目录
要从中卸载包的目录。

显示选项

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

另请参阅

cargo(1)cargo-install(1)