<PackageName>_ROOT

3.12 版本新增。

这是一个 CMake 环境变量。其初始值取自调用进程环境。

调用 find_package(<PackageName>) 时，将在 <PackageName>_ROOT 环境变量指定的目录前缀中进行搜索，其中 <PackageName> 是传递给 find_package() 调用时（保留大小写）的名称，而 _ROOT 是字面量。例如，find_package(Foo) 将在 Foo_ROOT 环境变量（如果已设置）指定的目录前缀中进行搜索。请参阅策略 CMP0074。

此变量可能包含单个目录前缀，或者在 UNIX 系统上使用 : 分隔的目录前缀列表，或在 Windows 系统上使用 ; 分隔的目录前缀列表（与这些平台上的 PATH 环境变量约定相同）。

另请参阅 CMake 变量 <PackageName>_ROOT。

<PACKAGENAME>_ROOT

在 3.27 版本中新增。

调用 find_package(<PackageName>) 时，还将在大写的 <PACKAGENAME>_ROOT 环境变量指定的目录前缀中进行搜索。请参阅策略 CMP0144。

注意

请注意，<PackageName>_ROOT 和 <PACKAGENAME>_ROOT 环境变量仅在具有区分大小写环境的平台上是不同的。