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