cargo-locate-project(1)

名称

cargo-locate-project — 打印 Cargo.toml 文件位置的 JSON 表示

概要

cargo locate-project [选项]

描述

此命令将向 stdout 打印一个 JSON 对象，其中包含清单的完整路径。清单通过从当前工作目录开始向上搜索名为 Cargo.toml 的文件来找到。

如果项目恰好是工作区的一部分，则输出项目的清单，而不是工作区根目录。可以使用 --workspace 标志覆盖此行为。根工作区通过进一步向上遍历或在找到工作区成员的清单后使用字段 package.workspace 来找到。

选项

--workspace

定位工作区根目录下的 Cargo.toml，而不是当前的工作区成员。

显示选项

--message-format fmt

打印项目位置的表示形式。有效值：

• json (默认)：JSON 对象，路径在键 “root” 下。
• plain: 仅路径。

-v

--verbose

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

-q

--quiet

不打印 cargo 日志消息。也可以使用 term.quiet 配置值指定。

--color when

控制何时使用彩色输出。有效值：

• auto (默认)：自动检测终端是否支持颜色。
• always: 始终显示颜色。
• never: 从不显示颜色。

也可以使用 term.color 配置值指定。

清单选项

--manifest-path path

Cargo.toml 文件的路径。默认情况下，Cargo 在当前目录或任何父目录中搜索 Cargo.toml 文件。

通用选项

+工具链

如果 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 locate-project
   

另请参阅

cargo(1), cargo-metadata(1)