CMAKE_FIND_REQUIRED

在 4.1 版本中新增。

如果启用，以下命令将被视为带有 REQUIRED 关键字，除非提供了 OPTIONAL 关键字。

• find_package()

• find_program()

• find_library()

• find_path()

• find_file()

当 find_package() 加载 Find<PackageName>.cmake 或 <PackageName>Config.cmake 模块时，CMAKE_FIND_REQUIRED 变量会在其中自动取消设置，以恢复嵌套查找操作的默认行为。该模块可以自行设置 CMAKE_FIND_REQUIRED 变量来选择加入该行为。

请注意，启用此变量会破坏一些常用模式。有时会使用对 find_package() 的多次调用来获得与默认值不同的搜索顺序。

另请参阅 CMAKE_REQUIRE_FIND_PACKAGE_<PackageName>，用于使 find_package() 调用成为 REQUIRED，以及有关启用这些变量如何破坏常用模式的更多信息。