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 變數。