CMakeLists.txt之add_subdirectory_cmakelist.txt 子目录-CSDN博客

本文链接：https://blog.csdn.net/zhiyuan2021/article/details/129032051

本文详细介绍了CMakeLists.txt中的add_subdirectory命令，包括其功能、参数解析以及不同场景下的实例应用。通过不同场景的构建演示，展示了如何控制子目录的输出路径，以及EXCLUDE_FROM_ALL参数如何影响子目录目标文件的构建。文章还提到了当父目录目标依赖子目录目标时，即使排除子目录，也会根据依赖关系生成子目录的目标文件。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、介绍

该命令是添加一个子目录并构建该子目录，命令格式为

add_subdirectory (source_dir [binary_dir] [EXCLUDE_FROM_ALL])

命令解析

source_dir
必选参数。该参数指定一个子目录，子目录下应该包含CMakeLists.txt文件和代码文件。子目录可以是相对路径也可以是绝对路径，如果是相对路径，则是相对当前目录的一个相对路径。
binary_dir
可选参数。该参数指定一个目录，用于存放输出文件。可以是相对路径也可以是绝对路径，如果是相对路径，则是相对当前输出目录的一个相对路径。如果该参数没有指定，则默认的输出目录使用source_dir。
EXCLUDE_FROM_ALL
可选参数。当指定了该参数，则子目录下的目标不会被父目录下的目标文件包含进去，父目录的CMakeLists.txt不会构建子目录的目标文件，必须在子目录下显式去构建。例外情况：当父目录的目标依赖于子目录的目标，则子目录的目标仍然会被构建出来以满足依赖关系（例如使用了target_link_libraries）。

二、实例

目录结构及说明如下：

├── CMakeLists.txt    #父目录的CMakeList.txt
├── main.cpp    #源文件，包含main函数
├── sub    #子目录
 └── CMakeLists.txt    #子目录的CMakeLists.txt
 └── test.h    #子目录头文件
 └── test.cpp    #子目录源文件

子目录sub 下的test.cpp定义了一个函数test()，将输入参数打印出来，相应的头文件test.h则对test()进行声明，CMakelists.txt则将sub下的源文件编译成库文件。

//  sub/test.cpp  
#include "test.h"
#include <iostream>

void test(std::string str)
{
   
   
    std::cout << str << std::endl