CMAKE_FIND_USE_PACKAGE_REGISTRY

在版本 3.16 中新增。

控制 find_package() 命令的預設行為，以決定是否搜尋 使用者套件註冊表 提供的路徑。

預設情況下，此變數未設定，其行為將回退到由已棄用的 CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY 變數所決定。如果該變數也未設定，則 find_package() 將使用 使用者套件註冊表，除非提供了 NO_CMAKE_PACKAGE_REGISTRY 選項。

當兩者皆設定時，此變數優先於 CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY。

在某些情況下，例如僅定位系統範圍的安裝，不希望在搜尋套件時使用 使用者套件註冊表。如果 CMAKE_FIND_USE_PACKAGE_REGISTRY 變數為 FALSE，則所有 find_package() 命令都將跳過 使用者套件註冊表，如同它們被調用時使用了 NO_CMAKE_PACKAGE_REGISTRY 參數一樣。

另請參閱 停用套件註冊表 以及 CMAKE_FIND_USE_CMAKE_PATH、CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH、CMAKE_FIND_USE_INSTALL_PREFIX、CMAKE_FIND_USE_CMAKE_SYSTEM_PATH、CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH、CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY 和 CMAKE_FIND_USE_PACKAGE_ROOT_PATH 變數。