cmakelist 增加源程序子目录

### 如何在 CMakeLists 文件中包含源代码子目录

当项目结构较为复杂，源文件分布于多个子目录时，在`CMakeLists.txt`中合理配置能够简化构建过程并提高维护效率。对于这种情况，可以利用`add_subdirectory()`指令来引入子目录下的资源。

#### 使用 `add_subdirectory()`

通过调用`add_subdirectory(subdirectory_name)`命令，可以让顶层的`CMakeLists.txt`识别指定名称的子目录，并处理该子目录内的同名文件[^3]。这不仅限于单层嵌套；如果存在更深级别的层次结构，则可以在相应的中间级`CMakeLists.txt`继续添加此命令指向更深层的子目录。

#### 示例：多模块项目设置

假设有一个简单的算术运算库分为加法(`Add`)和减法(`Subtract`)两个部分，各自位于独立的文件夹内：

ProjectRoot/
├── Add/
│   ├── Add.h
│   └── Add.cpp
├── Subtract/
│   ├── Subtract.h
│   └── Subtract.cpp
└── main.cpp

为了使这些组件能被正确编译链接成最终的应用程序，根目录下的`CMakeLists.txt`应如下所示定义：

# 设置最低版本需求
cmake_minimum_required(VERSION 3.10)

# 定义项目名称及其默认语言环境
project(ArithmeticOperations LANGUAGES CXX)

# 将 'Add' 和 'Subtract' 子目录加入构建系统
add_subdirectory(Add)
add_subdirectory(Subtract)

# 构建目标可执行文件, 并关联所有必要的源文件
add_executable(${PROJECT_NAME} main.cpp)
target_link_libraries(${PROJECT_NAME} PRIVATE AddLib SubtractLib)

这里假定每个操作对应的子目录都有自己的静态或共享库作为产物（即`AddLib`, `SubtractLib`），并且已经在各自的`CMakeLists.txt`里声明过了。因此，在顶级列表中只需要简单地引用它们即可完成整个项目的组装工作[^4]。

#### 关键点总结

- **递归加载**：借助`add_subdirectory()`实现对任意深度子树的支持；
- **分而治之**：让各个功能单元自给自足，保持良好的解耦合度；
- **集中管理依赖关系**：由最上层统一规划各部件间的相互作用模式。