CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY

在版本 3.16 中新增。

控制 系統套件登錄檔 的搜尋，由 find_package() 命令執行。

預設情況下，此變數未設定，行為將回退到由已棄用的 CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY 變數所決定。如果該變數也未設定，則 find_package() 將使用 系統套件登錄檔，除非提供了 NO_CMAKE_SYSTEM_PACKAGE_REGISTRY 選項。

當兩者都設定時，此變數優先於 CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY。

在某些情況下，例如僅定位使用者特定的安裝，不希望在搜尋套件時使用 系統套件登錄檔。如果 CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY 變數為 FALSE，則所有 find_package() 命令都將跳過 系統套件登錄檔，如同它們被呼叫時帶有 NO_CMAKE_SYSTEM_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_PACKAGE_REGISTRY 和 CMAKE_FIND_USE_PACKAGE_ROOT_PATH 變數。