CMAKE_LIST_FILE_NAME

4.0 版本新增。

CMake 项目文件的名称。这决定了 CMake 配置时处理的顶级文件，以及由 add_subdirectory() 处理的文件。

默认情况下，它是 CMakeLists.txt。如果设置为其他任何值，则当在项目子目录中找不到指定的 CMake 文件时，将回退使用 CMakeLists.txt。

此变量报告通过 cmake --project-file 选项设置的值。此变量的值绝不应由项目或用户直接设置。

警告

使用替代项目文件名仅供开发人员在增量过渡期间临时使用，不适用于最终产品的发布。当项目文件名不是 CMakeLists.txt 时，CMake 始终会发出警告。