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