cargo-locate-project(1)

名称

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

概要

cargo locate-project [选项]

描述

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

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

选项

--workspace

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

显示选项

--message-format fmt

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

• json（默认）：JSON 对象，路径位于键“root”下。
• plain：仅路径。

-v

--verbose

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

-q

--quiet

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

--color 何时

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

• auto（默认）：自动检测终端上是否支持彩色。
• always：始终显示颜色。
• never：从不显示颜色。

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

清单选项

--manifest-path 路径

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

常用选项

+工具链

如果使用 rustup 安装了 Cargo，并且 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 locate-project
   

另请参阅

cargo(1)，cargo-metadata(1)