CMAKE_FIND_USE_INSTALL_PREFIX

在 3.24 版本中已添加。

控制以下命令的默认行为，即是否搜索 CMAKE_INSTALL_PREFIX 和 CMAKE_STAGING_PREFIX 变量中的位置。

• find_program()

• find_library()

• find_file()

• find_path()

• find_package()

这在交叉编译环境中非常有用。

由于与 CMAKE_FIND_NO_INSTALL_PREFIX 的向后兼容性，find 命令的行为会基于此变量是否存在而改变。

CMAKE_FIND_USE_INSTALL_PREFIX	CMAKE_FIND_NO_INSTALL_PREFIX	搜索
未定义	开	否
未定义	关 || 未定义	是
关	开	否
关	关 || 未定义	否
开	开	是
开	关 || 未定义	是

默认情况下，此变量未定义。赋予上述命令的显式选项优先于此变量。

另请参见 CMAKE_FIND_USE_CMAKE_PATH、CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH、CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH、CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY、CMAKE_FIND_USE_PACKAGE_REGISTRY 和 CMAKE_FIND_USE_PACKAGE_ROOT_PATH 变量。