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 的向后兼容性，查找命令的行为会根据此变量是否存在而改变。

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 变量。