CMake+Conan多模块项目头文件依赖问题：嵌套引用的头文件无法被解析

看起来你遇到的核心问题是嵌套头文件的包含路径未正确配置，再加上项目模块划分不清晰，导致messageA.h能被找到，但它引用的messageUtilityA.h找不到。先帮你梳理下清晰的项目结构（根据你的描述整理），再给出两种可行的解决方案：

先明确你的项目结构（整理后） #

project/
├── CMakeLists.txt
├── src/
│   └── classA.cpp          # 需要 #include "Messages/messageA.h"
├── include/
│   └── classA.h
├── SecondFolder/
│   ├── include/
│   │   ├── Messages/
│   │   │   ├── messageA.h  # 引用 <MessageUtilities/messageUtilityA.h> 或 "MessageUtilities/messageUtilityA.h"
│   │   │   └── messageB.h
│   │   └── MessageUtilities/
│   │       └── messageUtilityA.h
└── ExampleProject/
    ├── src/
    │   └── example.cpp     # 需要 #include "classA.h" 和 #include "Messages/messageA.h"
    └── CMakeLists.txt

问题根源分析 #

你当前把SecondFolder的内容打包进了base库，但只配置了SecondFolder/include作为包含目录，却没正确处理MessageUtilities头文件的安装和路径传递。另外，你的PUBLIC_HEADER配置只手动指定了个别头文件，漏掉了messageUtilityA.h这类嵌套的头文件，导致Conan安装后，这些依赖头文件没被同步到包的include目录里。

方案一：拆分SecondFolder为独立库（推荐，模块化更清晰） #

既然SecondFolder里的Messages和MessageUtilities是独立的模块，不如把它做成单独的库（比如叫messages_utils），这样依赖关系更明确，也符合Conan的组件化包管理逻辑：

1. 改造根目录CMakeLists.txt #

project(base CXX)

# --------------------------
# 第一步：构建messages_utils独立库
# （如果SecondFolder有cpp文件，就用STATIC/SHARED，这里假设只有头文件，用INTERFACE库）
# --------------------------
add_library(messages_utils INTERFACE)
# 让依赖这个库的目标自动获得SecondFolder的include路径
target_include_directories(messages_utils
  PUBLIC
    ${PROJECT_SOURCE_DIR}/SecondFolder/include
)

# 如果SecondFolder有源文件，改成这样：
# add_library(messages_utils STATIC
#   SecondFolder/src/xxx.cpp  # 替换成你的实际源文件
# )
# target_include_directories(messages_utils PUBLIC SecondFolder/include)

# --------------------------
# 第二步：构建base库（对应原来的classA模块）
# --------------------------
add_library(base src/classA.cpp)
target_include_directories(base
  PUBLIC
    include
)
# 让base库PUBLIC依赖messages_utils，这样所有依赖base的目标都会自动继承messages_utils的包含路径
target_link_libraries(base PUBLIC messages_utils)

# --------------------------
# 第三步：安装配置（同时安装两个库）
# --------------------------
# 安装base库
install(TARGETS base messages_utils
  EXPORT base-targets
  LIBRARY DESTINATION lib
  ARCHIVE DESTINATION lib
  PUBLIC_HEADER DESTINATION include
)

# 批量安装所有头文件（避免手动列举）
install(DIRECTORY include/
  DESTINATION include
  FILES_MATCHING PATTERN "*.h"
)
install(DIRECTORY SecondFolder/include/
  DESTINATION include
  FILES_MATCHING PATTERN "*.h"
)

2. 调整Conanfile.py（支持组件化） #

需要让Conan识别到包内的两个组件（base和messages_utils），并传递正确的依赖关系：

from conans import ConanFile, CMake

class BaseConan(ConanFile):
    name = "base"
    version = "0.1"
    settings = "os", "compiler", "build_type", "arch"
    exports_sources = "CMakeLists.txt", "src/*", "include/*", "SecondFolder/*"
    generators = "cmake"

    def build(self):
        cmake = CMake(self)
        cmake.configure()
        cmake.build()

    def package(self):
        cmake = CMake(self)
        cmake.install()

    def package_info(self):
        # 配置base组件
        self.cpp_info.components["base"].libs = ["base"]
        self.cpp_info.components["base"].includedirs = ["include"]
        # 配置messages_utils组件（如果是INTERFACE库，libs为空）
        self.cpp_info.components["messages_utils"].libs = []
        self.cpp_info.components["messages_utils"].includedirs = ["include"]
        # 让base组件依赖messages_utils，这样依赖base的目标自动继承messages_utils的包含路径
        self.cpp_info.components["base"].requires = ["messages_utils"]

3. ExampleProject的CMake配置 #

只需要链接base组件即可（因为base已经依赖了messages_utils）：

project(example CXX)
add_executable(example src/example.cpp)

# 直接链接base，嵌套的头文件路径会自动传递
target_link_libraries(example base::base)

方案二：不拆分库，快速修复现有配置 #

如果不想拆分模块，可以通过补全包含路径+批量处理头文件安装来快速修复：

修改根目录CMakeLists.txt #

project(base CXX)

add_library(base src/classA.cpp)

# 补全所有需要的根包含目录
target_include_directories(base
  PUBLIC
    include
    ${PROJECT_SOURCE_DIR}/SecondFolder/include
)

# 批量获取所有需要公开的头文件（避免手动列举遗漏）
file(GLOB_RECURSE BASE_PUBLIC_HEADERS
  "${PROJECT_SOURCE_DIR}/include/*.h"
  "${PROJECT_SOURCE_DIR}/SecondFolder/include/**/*.h"
)

set_target_properties(base PROPERTIES
  PUBLIC_HEADER "${BASE_PUBLIC_HEADERS}"
)

# 安装目标+批量安装头文件（确保所有嵌套头文件都被安装到包目录）
install(TARGETS base
  EXPORT base-targets
  LIBRARY DESTINATION lib
  ARCHIVE DESTINATION lib
  PUBLIC_HEADER DESTINATION include
)

# 额外用install(DIRECTORY)确保目录结构和源码一致
install(DIRECTORY SecondFolder/include/
  DESTINATION include
  FILES_MATCHING PATTERN "*.h"
)

调整Conanfile.py #

只需要确保包含路径指向安装后的根include目录即可：

from conans import ConanFile, CMake

class BaseConan(ConanFile):
    name = "base"
    version = "0.1"
    settings = "os", "compiler", "build_type", "arch"
    exports_sources = "CMakeLists.txt", "src/*", "include/*", "SecondFolder/*"
    generators = "cmake"

    def build(self):
        cmake = CMake(self)
        cmake.configure()
        cmake.build()

    def package(self):
        cmake = CMake(self)
        cmake.install()

    def package_info(self):
        self.cpp_info.libs = ["base"]
        self.cpp_info.includedirs = ["include"]

为什么之前的配置会失败？ #

1. PUBLIC_HEADER配置遗漏：你只手动指定了messageA.h，漏掉了messageUtilityA.h，导致Conan安装后这个头文件没被同步到包的include目录。
2. 路径书写错误：你的set_target_properties里用了{PROJECT_SOURCE_DIR}（少了$符号），而且路径写错成了SecondFolder/include/Messages/include/MessageA.h，实际应该是SecondFolder/include/Messages/messageA.h。
3. 模块划分模糊：把独立的消息模块和classA打包在一起，导致依赖关系传递不清晰，容易出现路径遗漏。

内容来源于stack exchange