<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 环境变量的区分仅在具有区分大小写环境变量的平台上才有效。