CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY

3.16 版新增。

控制 find_package() 命令是否搜索 系统包注册表 (System Package Registry)。

默认情况下，此变量未设置，其行为将回退到由已弃用的 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 变量。