Conan包中头文件存在但CMake编译时找不到的问题排查

核心问题分析 #

编译找不到头文件的原因有两点：

1. 头文件目录嵌套错误：打包后包内头文件路径为include/mylib/mylib/MyHeader_Interface.h，比预期多了一层mylib目录——这是因为原项目的include/mylib被完整复制到了包的include目录下，导致路径重复嵌套。
2. Conan包配置错误：package_info中使用绝对路径拼接includedirs是Conan 1.x的错误用法，且路径设置与实际头文件结构不匹配。

具体解决方案 #

方案一：修正打包逻辑（推荐） #

1. 调整原项目CMakeLists.txt的安装规则

确保头文件安装时只复制include/mylib下的内容到包的include/mylib目录，而非整个include目录：

# 原项目CMakeLists.txt中添加或修改install指令
install(DIRECTORY include/mylib/ 
        DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/mylib
        FILES_MATCHING PATTERN "*.h")

这样打包后，包内头文件路径会变成include/mylib/MyHeader_Interface.h，符合预期的命名空间结构。

2. 修正Conan包的package_info配置

删除绝对路径拼接，直接设置相对包根目录的路径：

def package_info(self):
    super().package_info()
    self.cpp_info.includedirs = ["include"]  # 相对包根的路径，Conan会自动处理绝对路径
    self.cpp_info.libs = ["mylib"]  # 确保静态库名称被正确暴露给消费项目

此时消费项目中#include "mylib/MyHeader_Interface.h"就能通过include目录找到对应文件。

方案二：临时适配现有目录结构（不推荐） #

如果暂时无法修改原项目CMake配置，可调整Conan包配置和代码引用方式：

1. 修改package_info的includedirs：

def package_info(self):
    super().package_info()
    self.cpp_info.includedirs = ["include/mylib"]

2. 消费项目中修改头文件引用：

#include "MyHeader_Interface.h"

这种方式只是临时 workaround，会破坏头文件的命名空间结构，不建议长期使用。

额外注意点 #

• 你的conan_pkg.py中conan属性的缩进存在错误，需确保它属于ConanFile类的成员；同时get_exports_sources需要导入Iterable类型（from typing import Iterable）。
• Conan 1.x中cpp_info.includedirs始终使用相对包根的路径，绝对路径拼接会导致跨平台或不同环境下的路径错误。

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