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