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