问如何构建包含多个相互依赖的子目录的C++项目？

EN

由于项目中的目录结构只是为了保持文件的组织，因此一种方法是使用CMakeLists.txt自动查找src目录中的所有源文件，并将所有目录添加为包含头文件的目录。以下CMake文件可以作为起点：

cmake_minimum_required(VERSION 3.12)

project (Foo)

file (GLOB_RECURSE Foo_SOURCES CONFIGURE_DEPENDS "src/*.cpp")
file (GLOB_RECURSE Foo_HEADERS CONFIGURE_DEPENDS "src/*.h")

set (Foo_INCLUDE_DIRS "")
foreach (_headerFile ${Foo_HEADERS})
    get_filename_component(_dir ${_headerFile} PATH)
    list (APPEND Foo_INCLUDE_DIRS ${_dir})
endforeach()
list (REMOVE_DUPLICATES Foo_INCLUDE_DIRS)

add_executable(FooExe ${Foo_SOURCES})
target_include_directories(FooExe PRIVATE ${Foo_INCLUDE_DIRS})

两个file(GLOB_RECURSE ...命令确定源文件和头文件集。foreach循环从所有头文件的列表中计算包含目录的集合。glob标志告诉CMake在构建时重新运行CONFIGURE_DEPENDS命令。

计算源文件集的一个缺点是，当新文件添加到源树中时，CMake不会自动检测。然后，您必须手动重新创建构建文件。

我不是CMake方面的专家，但由于没有其他答案，我将看一看文档并试一试。在不同的目录中组织源代码和包含文件几乎是常态。

看起来像是CMake允许你给出包含目录的列表：http://www.cmake.org/cmake/help/cmake-2-8-docs.html#command:include_directories

所以就像这样：

include_directories("src/top1/mid1/bot1" "src/top1/mid1/bot2/" ... )

这些文件被传递给编译器，这样它就可以找到头文件，并将为每个源文件传递这些文件。因此，您的任何源文件都应该能够包含任何头文件(我认为这就是您所要求的)。

与此类似，您应该能够在add_executable命令中列出所有源文件：

add_executable(name "src/top1/mid1/bot1/src1.cpp" "src/top1/id1/bot2/src2.cpp" ...)

因此，这将是一种让一切都构建起来的天真方式。将编译每个源文件，并在所有这些目录中查找头文件，然后将目标文件链接在一起。考虑是否有任何方法可以简化这一点，这样你就不需要这么多的include文件夹，也许只有几个公共的头文件需要被所有源文件引用。如果事情变得更复杂，你可以将子层次结构构建到库中，等等。还可以考虑分离源文件和头文件(例如，在src和include中)。

虽然@sakra对这个问题给出了一个很好的答案，但我认为更深入地探讨它更合适。

出于许多原因，我们希望将我们的代码分成模块和库。像代码封装，可重用性，更容易调试等等。这个想法也会在编译过程中传播。

换句话说，我们希望将编译过程划分为几个小的编译步骤，每个步骤属于一个模块。因此，每个模块都必须有自己的编译过程。这就是为什么我们要为每个目录使用一个CMakeLists.txt文件。因此，每个目录都有自己的编译命令，并且在项目的根目录中会有一个主CMakeLists.txt文件。

下面是一个例子。考虑项目的以下结构：

src/
|
- main.cpp
|
_sum/
    |
    - sum.h
    |
    - sum.cpp

我们将为每个目录提供一个CmakeLists.txt。第一个目录是项目的根目录，其中包含src/文件夹。以下是该文件内容：

cmake_minimum_required(VERSION 3.4)
project(multi_file)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_FLAGS "-Wall")

add_subdirectory(src) 

下一个CMakeLists.txt将位于src/目录：

add_subdirectory("sum")

add_executable(out main.cpp)
target_link_libraries(out sum)

最后一个文件将位于sum/目录中：

add_library(sum SHARED sum.cpp)

我希望这能帮到你。我创建了一个github repository，以防您觉得需要查看代码或需要进一步解释。