问CMAKE_CURRENT_SOURCE_DIR与CMAKE_CURRENT_LIST_DIR的区别

EN

定义

CMAKE_SOURCE_DIR：包含CMakeList.txt文件的最顶层文件夹(源目录)。这个值在不同的作用域中永远不会改变。

PROJECT_SOURCE_DIR：包含CMakeList.txt文件的最近的文件夹，它有自己的作用域，包含project()命令。

CMAKE_CURRENT_SOURCE_DIR：包含具有自己范围的CMakeList.txt文件的最近的文件夹。(文件不需要包含project()命令)

CMAKE_CURRENT_LIST_DIR：包含当前已处理的CMakeList.txt或.cmake文件的文件夹。

我的意思是它本身的范围与范围规则有关。虽然include(file)命令没有创建新的作用域，但是add_subdirectory正在创建一个影响PROJECT_SOURCE_DIR和CMAKE_CURRENT_SOURCE_DIR值的新范围。

示例

让项目结构如下：

A/
=> CMakeList.txt
=> B/
   => CMakeList.txt

让我们假设通过将消息命令放入子文件夹B中的CMakeList.txt文件来打印所有cmake变量。

• 如果文件夹A中的CMakeList.txt包含一个包含(“B/CMakeList.txt”)行，那么

CMAKE_SOURCE_DIR将是源目录，即“到项目/A的路径”。

PROJECT_SOURCE_DIR将是“到项目/ A的路径”，因为CMakeList.txt命令不会创建新的作用域，而且最近的CMakeList.txt文件具有自己的作用域并包含项目命令，位于文件夹A中。

CMAKE_CURRENT_SOURCE_DIR将是“到项目/ A的路径”，因为CMakeList.txt命令不会创建新的作用域，而且离它最近的具有自己范围的CMakeList.txt文件位于文件夹A中。

CMAKE_CURRENT_LIST_DIR将是“项目/A/ B的路径”，因为当前处理的文件位于子文件夹B中。

• 如果CMakeList.txt包含一行add_subdirectory("./B")，那么

CMAKE_SOURCE_DIR将是源目录，即“到项目/A的路径”。

PROJECT_SOURCE_DIR将是“到项目/A/ B的路径”，因为add_subdirectory命令创建了一个新的作用域，并且最近的CMakeList.txt文件有它自己的作用域并包含项目命令在子文件夹B中。

CMAKE_CURRENT_SOURCE_DIR将是“到项目/A/ B的路径”，因为add_subdirectory命令创建了一个新的作用域，并且最接近的具有自己范围的CMakeList.txt文件位于子文件夹B中。

CMAKE_CURRENT_LIST_DIR将是“项目/A/ B的路径”，因为当前处理的文件位于子文件夹B中。

参考：https://gitlab.kitware.com/cmake/community/-/wikis/doc/cmake/Useful-Variables