如何在CMake中保留项目目录结构并正确使用#include？

我懂你这糟心的情况——明明按预期的目录结构摆好了代码，结果写#include "libA/fileA.h"时CMake死活找不到头文件，非得在libA里再套一层同名目录才能正常编译。其实问题核心很简单：CMake没把项目根目录（或者libA的父级目录）添加到编译器的包含搜索路径里，下面给你几个实用的解决办法：

方法一：在顶层CMakeLists.txt中添加全局包含路径 #

直接在项目根目录的CMakeLists.txt里，把根目录本身加入包含路径，这样所有子模块都能基于根目录来引用头文件：

# 顶层CMakeLists.txt
cmake_minimum_required(VERSION 3.10)
project(MyProject)

# 将项目根目录添加到全局包含路径
include_directories(${PROJECT_SOURCE_DIR})

# 引入子项目
add_subdirectory(libA)
add_subdirectory(program1)

这样一来，program1/main.cpp里的#include "libA/fileA.h"就能被编译器正确识别，因为它会从项目根目录开始逐层查找。

方法二：基于目标管理的模块化设置（推荐） #

如果不想污染全局包含路径，更符合CMake现代最佳实践的方式是让libA自己管理包含路径，并把这个路径导出给依赖它的模块：

# libA/CMakeLists.txt
add_library(libA STATIC fileA.cpp)

# 将项目根目录设为libA的公共包含路径，依赖它的目标会自动继承这个路径
target_include_directories(libA PUBLIC ${PROJECT_SOURCE_DIR})

然后在program1的配置里，只需要链接libA，就能自动获取它的包含路径：

# program1/CMakeLists.txt
add_executable(program1 main.cpp)

# 链接libA，同时自动继承它的包含路径配置
target_link_libraries(program1 libA)

这种方式的好处是依赖关系更清晰，不会给不相关的模块强加包含路径。

额外提醒 #

尽量避免使用include_directories这类全局命令，优先用target_include_directories配合PUBLIC/PRIVATE/INTERFACE关键字来管理，这样项目的可维护性会高很多，也不容易出现奇怪的路径冲突问题。

内容的提问来源于stack exchange，提问作者Code_So1dier