cargo-remove(1)

定义

cargo-remove - 移除Cargo.toml配置清单文件中的依赖项

概要

cargo remove [options] dependency...

说明

从 Cargo.toml 配置清单中移除一个或多个依赖项。

选项

条目选项

--dev: 移除开发依赖。
--build: 移除构建依赖。
--target target: 移除指定目标平台的依赖。

其他选项

--dry-run: 非实际写入配置清单。

显示选项

-v

--verbose

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

-q

--quiet

不打印 cargo 日志信息。也可以用 term.quiet 配置。

--color when

使用彩色输出。有效值:

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

也可以用 term.color 配置。

配置选项

--manifest-path path

Cargo.toml 文件的路径。默认, Cargo 在当前目录和任意父目录搜索 Cargo.toml 文件。

--frozen

--locked

这些标志都要求 Cargo.lock 文件是最新的。如果lock文件丢失, 或是需要更新, Cargo会返回错误并退出，--frozen 选项还会阻止cargo通过网络来判断其是否过期。

可以用于断言 Cargo.lock 文件是否最新状态(例如CI构建)或避免网络访问。

--offline

阻止Cargo访问网络。如果不指定该选项，Cargo会在需要使用网络但不可用时停止构建并返回错误。设置该标识，Cargo将尽可能不使用网络完成构建。

需注意，这样可能会导致与在线模式不同的依赖处理，Cargo将限制仅使用已下载到本地的crate，即使本地索引中有更新版本。查阅 cargo-fetch(1) 命令，在脱机前下载依赖。

也可以用 net.offline 配置。

包的选择

-p spec...
--package spec...: 移除包。

常规选项

+toolchain: 如果Cargo已经通过rustup安装，并且第一个传给 cargo 的参数以 + 开头，则当作rustup的工具链名称。(例如 +stable 或 +nightly). 查阅 rustup 文档了解关于工具链覆盖的信息。
--config KEY=VALUE or PATH: 覆盖Cargo配置项的值，该参数应当为TOML KEY=VALUE 语法，或者提供附加的配置文件的路径。该标识可以多次指定。查阅命令行覆盖部分获取更多信息
-h
--help: 打印帮助信息。
-Z flag: Cargo不稳定的(每日构建)标志。运行 cargo -Z help 了解详情。

环境

查阅参考了解Cargo读取环境变量。

退出状态

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

示例

移除 regex 依赖
```
cargo remove regex
```
移除 trybuild dev-依赖
```
cargo remove --dev trybuild
```

在 x86_64-pc-windows-gnu 依赖表移除 nom

cargo remove --target x86_64-pc-windows-gnu nom

参阅

cargo(1), cargo-add(1)