CXX_SCAN_FOR_MODULES

在 3.26 版本加入.

CXX_SCAN_FOR_MODULES 是一个布尔值，指定 CMake 是否将扫描目标中的 C++ 源以查找模块依赖项。另请参阅 CXX_SCAN_FOR_MODULES 了解每个源的设置，如果设置，将覆盖目标范围的设置。

如果在创建目标时设置了此属性，则该属性由 CMAKE_CXX_SCAN_FOR_MODULES 变量的值初始化。

当此属性设置为“ON”或未设置时，CMake 将在构建时扫描目标的“CXX”源，并根据需要将模块依赖信息添加到编译行。当此属性设置为“OFF”时，CMake 将不会在构建时扫描目标的“CXX”源。

请注意，仅当为目标启用了 C++20 或更高版本时才会执行扫描。始终执行扫描目标源中属于“CXX_MODULES”和“CXX_MODULES_HEADER_UNITS”类型文件集的模块。

备注

仅当“CMAKE_EXPERIMENTAL_CXX_MODULE_CMAKE_API”门启用了对 C++ 模块的实验性支持时，此设置才有意义。