CMAKE_MAXIMUM_RECURSION_DEPTH

在 3.14 版本中添加。

CMake 脚本的最大递归深度。它旨在通过命令行 -DCMAKE_MAXIMUM_RECURSION_DEPTH=<x> 设置，或者在需要较大递归深度的项目中的 CMakeLists.txt 中设置。设置此变量的项目应为用户提供一种覆盖它的方法。例如

# About to perform deeply recursive actions
if(NOT CMAKE_MAXIMUM_RECURSION_DEPTH)
  set(CMAKE_MAXIMUM_RECURSION_DEPTH 2000)
endif()

如果未设置，或者设置为非整数值，则使用合理的默认限制。如果达到递归限制，脚本将立即终止并显示致命错误。

调用以下任何命令都会增加递归深度

• include()

• find_package()

• add_subdirectory()

• try_compile()

• ctest_read_custom_files()

• ctest_run_script() (除非指定了 NEW_PROCESS)

• 用户定义的 function() 和 macro() (请注意，function() 和 macro() 本身不会增加递归深度)

• 读取或写入正在被 variable_watch() 监视的变量

另请参阅 CMAKE_MAXIMUM_RECURSION_DEPTH 环境变量。