<PackageName>_ROOT

在 3.12 版本中添加。

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

对 find_package(<PackageName>) 的调用将在由 <PackageName>_ROOT 环境变量（<PackageName> 是赋予 find_package() 调用的大写不敏感的名称，_ROOT 是文本）指定的目录中进行搜索。例如，find_package(Foo) 会在（如果设置）Foo_ROOT 环境变量中指定的目录进行搜索。请参阅策略 CMP0074。

此变量可以保存一个目录或由 :（在 UNIX 上）或 ;（在 Windows 上）分隔的目录列表（与这些平台上的 PATH 环境变量约定相同）。

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

<PACKAGENAME>_ROOT

在 3.27 版本中添加。

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

注意

注意，仅当平台具有区分大小写的环境时，<PackageName>_ROOT 和 <PACKAGENAME>_ROOT 环境变量才不同。