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，以及有关启用这些变量如何破坏常用模式的更多信息。